Files
Genarrative/docs/project-memory
lhk229 146b7a215f 文档:对抗性复核修正 project-planning 登记机制记录
复核结论:build.rs/specialist_nodes/validate_agent_catalog 等核心机制主张
逐行核对代码原文,全部准确(含所有 file:line 引用)。修正两处问题:

1. decision-log.md 声称 provider_request_builders.rs:536-539 与
   prompt.rs:416-417 报同一错误字符串「未知 Agent 模板:project-planning」,
   逐行核对后两处错误文案实际不同(后者是「未知 Agent:project-planning」,
   没有「模板」二字)。已改为分别引用真实文案。

2. 独立扫描 GAME_CREATOR_AGENT_GROUP_DEFINITIONS 遍历模式,发现一个
   R1 调研遗漏的 needs_change:task_start.rs 的
   collect_game_creator_agent_runtime_agent_ids 与
   game_creator_agent_role_definition 是同构的二分硬编码,是核心恢复驱动
   read_game_creator_agent_runtimes_at 与三处安全网(崩溃恢复扫描、steer
   级联取消、委派回执兜底对账)的枚举来源,project-planning 登记后不会
   被这三处发现。已追踪 agent.delegate 派发路径确认委派首轮任务同步起跑、
   不受影响,故定级 needs_change 而非 blocking。同时补记
   runtime_adapter.rs 里断言 catalog 精确集合的既有测试需要同步更新。

git diff 核对确认本轮及此前一轮均未改动任何 .rs 或 manifest.json。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-13 05:08:25 +00:00
..

项目记忆目录

本目录保存可以进入 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。