用途:为仓库生成智能体进入项目时读取的 AGENTS.md 及同内容 CLAUDE.md,把技术栈、知识库、各智能体可用技能、路线图与硬性规则集中到一个文件;在知识库或 CHANGES.md 变更后刷新项目指令。
前置检查:根目录需有 knowledge-base/ 及 knowledge-base/02_descripcion_general.md,否则不生成并提示先运行 kb-creator;需有 CHANGES.md,缺失时可生成但省略 Roadmap 段并提示运行 roadmap-generator。
读取来源:knowledge-base/02_descripcion_general.md 的技术栈表、README.md 的项目名与摘要、CHANGES.md 的关键路径与首个 change 摘要、.atl/skill-registry.md(技能真实来源,缺失时回退扫描 .claude/skills/ 与 ~/.claude/skills/)、knowledge-base/10_preguntas_abiertas.md 的高优先级不一致项,以及 ~/.claude/CLAUDE.md 全局指令以避免重复。
输出:AGENTS.md 与 CLAUDE.md 均放在根目录,内容为复制而非引用,不放在 .claude/ 或 openspec/ 内。结构含技术与知识库、技能到角色的映射表、路线图、项目硬性规则与工作流,并附一行说明:compact rules 由编排器从 .atl/skill-registry.md 解析。
硬性规则需按真实技术栈派生并经用户确认后写入,不写未确认规则;全局已定义的规则只引用不重复。注意:知识库缺失时不可用;只改单条规则建议直接编辑现有文件;自动化钩子属 settings.json 而非本文件。命令、技能名等细节以原资料为准。