lhk229
d3d0ae95e5
在技术方案第 3 节新增 3.1 小节：project-planning 登记为 agentCatalog 下与 supervisor 平级、不属于任何 group 的独立条目，使 specialist_nodes（只读 groups[].roles[]）、build.rs 的 validate_seed_task_catalog 与 16 任务种子 DAG 均不需要改动；给出 descriptor 元数据取值（groupId 自引用、不设 groupLabel、toolId 走 agent.runtime.* 命名族、capabilityAuthority 沿用 现有常量）与编译链路要改的确切位置清单。同时如实记录调研发现的新缺口： 仅做 catalog 登记不足以让 D11 静态委派可执行——prompt.rs 的 game_creator_agent_role_definition 硬编码「非 supervisor 即 group 角色」 二分，需 M1 补一个平行分支；另有 task_ops.rs 误分类兜底、 delegation.rs 的 agent.spawn_isolated 放行面扩权两处 needs_change。 同步更新第 23.1 节待裁决项（登记方式已定稿，代码留给 M1，真正的前置 是 prompt.rs 角色身份合成缺口）、第 1.1/2 节里因此过时的「待裁决」措辞 （避免与新结论自相矛盾），并在 decision-log.md 顶部补记本次定稿与 「做游戏链路一行不动」的机制依据。本轮仅涉及文档，不改任何 manifest.json 或 .rs 源码，注册代码留给 M1。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
项目记忆目录
本目录保存可以进入 Git 的项目级长期知识，供开发者和 Agent 读取。.hermes/ 只保留 Hermes 工具专用资源，不再作为项目知识库。
目录结构
docs/project-memory/
├─ README.md
├─ shared-memory/
│ ├─ project-overview.md
│ ├─ team-conventions.md
│ ├─ development-workflow.md
│ ├─ document-map.md
│ ├─ decision-log.md
│ ├─ pitfalls.md
│ └─ handoff-template.md
├─ plans/
└─ todos/
使用原则
- 开发前先读
AGENTS.md；复杂任务继续读取docs/【协作规范】Agent工作入口与执行准则-2026-06-22.md，再按任务读取docs/project-memory/shared-memory/和当前docs/文档。 - 长期有效的架构约定、接口变化、排障经验、开发流程和协作规则写入
shared-memory/。 - 阶段性计划写入
plans/，已确定但暂未实施的共享 TODO 写入todos/。 - 如果本目录内容与代码或最新
docs/冲突，以代码和最新docs/为准，并同步修正过期记忆。 - 禁止写入个人配置、API Key、Token、Cookie、会话记录、认证文件、本地私密路径、构建产物、日志、缓存和数据库 dump。
RAG 索引
本目录是 Agent 本地 RAG 的高权重索引源。RAG 主要用于 Agent 检索上下文，不替代人工阅读入口或正式文档地图。索引脚本位于 scripts/rag/，本地生成的 .rag/ 数据不提交 Git。