AGENTS.md · diff
git:20261027.3e5341d to git:20261031.86f03d1
3 added, 5 removed. Audit A to A.
# AgentForge 项目知识维护
- - 项目知识入口是 `docs/wiki/README.md`,约定保存在 `docs/wiki/wiki.config.json`。Wiki 为理解项目提供背景;需求、源码和实际验证仍按各自证据核实。
- - 引用 Wiki 作决策前,运行 `npm run wiki:freshness -- --module <模块ID>`;跨模块阅读可省略模块参数。`stale`、`unknown` 或 `blocked` 不能表述为当前已确认事实,应读取相关来源核实,并说明缺口。
- - 关联来源包括源码、规则文档、配置和测试。开发收尾时检查实际 diff 与受影响 Wiki,按授权范围更新文档或明确记录“无需更新”的理由;规则冲突未解决时记录 `blocked`,不改写规则掩盖问题。
- - 完成复核后才运行 `npm run wiki:review -- --module <模块ID> --decision <结论> --reason <具体依据> --reviewer <实际执行者> --evidence '["项目相对路径"]'`。结论为 updated、no-change 或 blocked。该命令只保存复核记录,不代替语义核实;禁止为了过门而批量刷新记录。
- - 交付前运行 `npm run wiki:check` 和 `npm run wiki:gate`。后者默认检查工作区;暂存内容使用 `-- --scope staged`。先暂存源码、Wiki 与配置,再按 staged 范围复核,最后暂存复核记录,避免工作区新记录掩盖待提交的旧内容。
+ - 项目知识入口是 `docs/wiki/README.md`。Wiki 为理解项目提供背景;需求、源码和实际验证仍按各自证据核实。
+ - 引用 Wiki 作决策前,按页面列出的来源回到代码核实;Wiki 只提供背景,不替代源码与验证。
+ - 代码行为变更后同步受影响的 Wiki 页面并运行 `node skills/wiki/scripts/wiki.mjs check`;目录或页面增减时同步 `docs/wiki/catalog.json` 与 `README.md` 导航。
- 仓库存在 `.codegraph/` 时,理解或定位代码优先使用 CodeGraph;没有时使用项目现有搜索工具,不自动建立索引。