build-agents-mdlisted

# Outcome 为目标仓库建立简洁、具体、可执行且可验证的 Agent 开发指南。正文统一维护在 `AGENTS.md`，同目录的 `CLAUDE.md` 通过相对符号链接共用内容；只有子目录确实存在不同约定时，才增加嵌套指令。 ## Routing - 根目录没有 `AGENTS.md` 时，执行初始化分支。 - 已有 `AGENTS.md` 时，允许整体重构；必须先展示完整内容预览，不默认保留原有章节结构。 - Monorepo 仅在子目录存在不同技术栈、命令、职责或关键约定时创建嵌套 `AGENTS.md`。 - 用户只要求审查、建议或预览时，停在只读阶段。 - 由 `vibe-coding` 等上层总控受控调用时，保留完整内容确认，但按上层提供的任务、提交和恢复契约返回结果。 - 普通 README、项目文档、通用 Agent 行为规范、测试框架或 CI 建设不属于本 Skill。 ## Steps 1. 研究目标仓库 - 完整读取 `workflows/§01-research.md` 和 `rules/content-admission.md`。 - 查清仓库结构、入口、真实命令、现有指令、文档、CI 与版本控制状态。 - 完成条件：每项拟写内容都有项目证据，每个嵌套文件都有明确用途。 2. 提供完整内容预览 - 完整读取 `workflows/§02-preview.md` 和 `templates/replacement-preview.template.md`。 - 列出全部新增、替换、删除与链接操作，并逐文件展示完整拟写正文。 - 完成条件：用户明确确认预览；不得在用户确认预览前写入。 3. 写入开发指南 - 确认后完整读取 `workflows/§03-authoring.md`、`rules/platform-and-scope.md` 和 `templates/agents-md.template.md`。 - 需要判断内容粒度时，只读取最接近目标项目形态的 `examples/` 示例。 - 完成条件：确认范围内的 `AGENTS.md` 与 `CLAUDE.md` 已完成写入，没有修改其他项目文件。 4. 验证 - 完整读取 `workflows/§04-validation.md` 和 `checklists/semantic-acceptance.md`。 - 运行 `scripts/validate_agents_md.py`；按风险补充真实、可复现的项目命令验证。 - 完成条件：静态检查、内容审查、命令验证状态与未验证内容分别记录。 5. 交付 - 完整读取 `workflows/§05-delivery.md`。 - 完成条件：独立调用时用户能决定适用���后续动作；受控调用时上层总控已获得修改内容、确认依据、验证证据、提交状态、未验证项和恢复条件。 ## Delivery - 说明根目录与子目录的指令安排，以及每个文件为何存在。 - 列出新增、替换、删除、链接和明确未处理的文件。 - 汇报实际运行的命令、结果、失败修复与“来源已确认、运行未验证”的命令。 - 区分静态校验、项目行为验证和真实客户端加载验证，不扩大结论。 - 实现与验证结束后，只询问一次是否执行当前仓库需要的后续操作：commit、push、更新本地 Claude Code Plugin、更新本地 Codex Plugin；未获确认