824183864e
- 去版本化：能力清单拆为三文档（产品需求清单/技术架构与模块/需求模块映射）， 文件名去 v2.1 版本号为唯一权威副本；删除混合视角旧档《业务能力全景与模块归属》， ~20 处交叉引用重定向（git 留史） - 模块 12→13：新增 game-module-studio（创作编排域），aigc 收敛为无状态生成原子； 锁风门 Gate(owner=compliance)、专区 Zone(owner=project) 两横切显式建模 - MVP 口径迁移：验收单位由"能力项(131)"改为 Doc A 的 55 项 P0 产品功能， 工作量≈137 技术项；CLAUDE/AGENTS/mvp-scope/执行 spec §7/工作流 全链同步 - 三轮评审（人工 + 3 独立 Opus）findings 已修复：0 断链/0 孤儿/0 重复 ID， 计数 155/204/137 实测自洽；glossary 补锁风门/专区/创作会话/资产图术语 - 新增 docs/memorys 任务记忆与 agent-specs 重划/prompt 治理评审依据 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
.agents/ —— 绘境AI 项目的 Agent 能力中枢
本目录沉淀并积累项目的全部 Agent 能力、技能与规则，让团队在长期开发中复利式积累知识、流程与能力，持续提升 AI 驱动开发的能力、准确率与稳定性。
工作入口指南见
../AGENTS.md；项目定位/目标/目录见../CLAUDE.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/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 治理手册 |
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的"沉淀"环节。