zizi 60e736ac1a docs(harness): 收口协议单清单化+四处漂移纠偏+配方出仓蒸馏——2026-06-11 harness 体检落地

体检根因：收口规则散落 4 处（总账铁律/作战清单回填铁律/README 维护规则/协议 §6）靠记忆执行
→ 漂移已实发（总账表头停 06-09 两日、作战清单轮次未滚动、.agent 残留 Day-0 横幅、AGENTS §3 仍写"三仓未入本仓"）。

- 新增 .agents/skills/wave-close-checklist.md：收口七步唯一可执行清单（总账+表头/作战清单+归档/回填/.agent 仅结构变化/蒸馏/索引/编排资产入库+30秒自检）；总账铁律、协议 §6、编排文档全部改为指向它
- 四处漂移一次纠偏：总账表头 06-11+对账 f403d11；game-cloud/.agent（Day-0→11/13 模块实态、技术栈对齐 C2 裁定、Wave4 销账）；game-studio/.agent（mock 态→接 staging 实态）；AGENTS.md §3 monorepo 实态+目录树补 contracts/game-*/deploy/mvp+memorys 标记停增
- 作战清单瘦身：3843 字符巨型 bullet 等完成史整体迁 MVP作战清单-完成史归档.md（原文快照保真），清单 68→33 行只留队列；新一轮完成线标注待创始人拍板重锁
- 配方出仓蒸馏（原仅存会话私有记忆）：skills/staging-ops.md（机器分工/git 同步/重部署字节码实证/前端构建门/冒烟）+ skills/ui-walkthrough-cdp.md（CDP 七坑/studio/admin 走查/信道探针）；README+AGENTS §5 索引同步（§5 顺带补回漏登的 add-game-template/prompt-governance）
- 编排器 .agent 户口：QA 工具箱定位/组件清单/纪律（新工具不再长进 runs/）/Doc B T-id 编目与 tools/ 迁移留待办
- 协议修正：§5 前端验证门 pnpm test→npm run build（vue-tsc 假门禁红线入文）；§1 历史检索改指 agent-specs 收口报告；mvp-execution-orchestration 加波次制现状注记（Day0-15/站会为目标态）
- .gitignore 加 __pycache__/.pytest_cache（注释说明与 build/ 老雷的区别）

遗留：nightly cron 哨兵（动 mini-desktop，待拍板）/ Doc B 未编目组件销账 / tools/ 迁移评估。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-06-11 13:26:04 +00:00

5.2 KiB

Raw Blame History

.agents/ —— 造梦AI 项目的 Agent 能力中枢

本目录沉淀并积累项目的全部 Agent 能力、技能与规则，让团队在长期开发中复利式积累知识、流程与能力，持续提升 AI 驱动开发的能力、准确率与稳定性。

工作入口、项目定位/目标/目录均见 ../AGENTS.md（项目唯一入口）；CLAUDE.md 仅以 @AGENTS.md 导入它。

一、本目录是什么

随着项目长期、跨会话推进，零散的认知和踩坑很容易丢失，AI 每次都"从零理解"。.agents/ 把这些沉淀成结构化、可检索、可复用的资产：事实蒸馏、硬约束、操作手册、元流程各归其位。每次任务从这里取经验、向这里存经验，能力随时间累积而非反复重置。

二、目录结构与职责

子目录	职责	回答的问题
`knowledge/`	事实与蓝图的蒸馏（产品、架构、范围、术语）	是什么
`rules/`	必须遵守的硬约束（工程规范、安全可靠性）	必须怎样
`skills/`	可复用操作手册 playbook（怎么做某一类事）	怎么做
`workflows/`	元流程（如何承接、推进、收尾一个任务）	如何承接任务

完整文件清单

knowledge/

文件	一句话说明
`knowledge/product-and-architecture.md`	产品定位、13 模块与依赖、三仓三端架构蒸馏
`knowledge/tech-decisions.md`	技术栈与关键选型理由
`knowledge/mvp-scope-and-milestones.md`	MVP 的 55 项 P0 产品功能范围、里程碑与验收指标
`knowledge/glossary.md`	术语表

rules/

文件	一句话说明
`rules/engineering-conventions.md`	命名/分层/API 路径/错误码/提交/PR 等工程规范
`rules/security-and-reliability.md`	安全基线、幂等、超时重试、合规与可靠性约束

skills/

文件	一句话说明
`skills/add-business-module.md`	新增一个 game-module 业务模块的标准步骤
`skills/add-game-template.md`	新玩法模板接入配方（契约→prompt→runtime→后端→编排器→五级验收门，merge 实战收口版）
`skills/ai-generation-pipeline.md`	AI 生成链路（Dify + OpenGame + aigc 壳）开发手册
`skills/runtime-and-multichannel.md`	运行时打包、沙箱、SDK 与多渠道导出手册
`skills/contract-first-development.md`	契约先行：契约对齐与并行解耦
`skills/prompt-governance.md`	Prompt 即第 8 契约：Registry/加载注入/eval 门禁/HITL 治理手册
`skills/wave-close-checklist.md`	波次收口七步检查单——所有收口铁律指向的唯一可执行清单
`skills/staging-ops.md`	staging 运维配方：机器分工/代码同步/后端重部署/前端构建门/冒烟门
`skills/ui-walkthrough-cdp.md`	真 UI 走查配方（CDP on mini-desktop）：studio/admin 走查 + CDP 七坑 + 信道探针

workflows/

文件	一句话说明
`workflows/ai-development-protocol.md`	任务承接→分析→评审→执行→验证→沉淀的完整协议
`workflows/mvp-execution-orchestration.md`	MVP 10-Agent×3周执行编排 + 8 条复利提效策略

三、使用方式（按任务类型查阅）

任务类型	先读	再读
分析	`workflows/ai-development-protocol.md` + 相关 `knowledge/`	原始 `docs/architecture/` 长文档
评审	`rules/`（拿约束当尺子） + `knowledge/`	对应 `skills/` 看实践标准
编码	对应 `skills/`（操作手册） + `rules/engineering-conventions.md`	`knowledge/` 对齐上下文
调试	`knowledge/glossary.md` + 相关 `skills/`	`rules/security-and-reliability.md`（排查可靠性/幂等问题）

通用顺序：先 knowledge 对齐事实 → 看 rules 划红线 → 用 skills 落地 → 按 workflows 推进与收尾。

四、维护规则（关键）

.agents/ 的价值取决于是否被持续、规范地维护。务必遵守：

何时新增 vs 更新现有
- 出现全新主题（新模块手册、新流程）→ 新增文件。
- 是对已有主题的补充/修正→ 更新现有文件，不要另起炉灶造重复。
先查重：新增前先检索本目录，避免重复条目和同义文件。
过时即处理：信息失效时立即修正或删除，不留误导性内容；与代码/文档冲突时以已验证事实为准。
单一主题、精炼、可检索：每个文件聚焦一个主题，用表格与要点，便于 Agent 快速定位；避免照搬源文档大段内容，做蒸馏与索引。
同步索引与交叉链接：任何对 .agents/ 的结构性变更（增/删/改名文件），都要同步更新本 README 的清单，以及 ../AGENTS.md 中相关导航与交叉链接，保持全局一致。
语言：一律使用简体中文。
相对路径链接：文件间交叉引用使用相对路径，保证仓库迁移后链接不失效。

维护本身就是任务收尾的一部分——见 workflows/ai-development-protocol.md 的"沉淀"环节。

5.2 KiB Raw Blame History Unescape Escape