Agent Readiness Fix
通过仅应用安全变更来提升仓库就绪度。引擎会规划并编写配置模板;你负责处理 git 和撰写任何散文内容。三个板块,三种不同的安全级别。
步骤
-
确保报告存在。 如果缺少
.agents/readiness/latest.json,请先运行 ra1-report 技能。 -
对计划进行试运行,查看将发生哪些变更:
python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <repo-path>它会打印出三个板块:自动应用(安全的配置模板)、提案(待审查的草稿)、GitHub 设置(手动操作)。
-
首先创建本地分支(绝不要在默认分支上工作):
git -C <repo-path> checkout -b readiness/fixes -
应用安全模板(幂等操作;如果工作区有未提交的变更则拒绝执行;绝不覆盖非空文件):
python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <repo-path> --apply -
自行撰写“提案”项目 — 如 README 章节、定制的
AGENTS.md、操作手册、首个测试。请将这些内容编写成供用户审查的草稿;不要编造与代码库无关的内容。templates/AGENTS.md是一个起始框架 — 请根据仓库的实际内容进行填充。 -
显示差异并本地提交。 总结变更内容,然后:
git -C <repo-path> add -A && git -C <repo-path> commit -m "chore: raise agent readiness"在提交消息末尾添加必需的
Co-Authored-By尾部信息。 -
重新运行 ra1-report,以查看就绪度级别的变化。
约定(不得违反)
- 未经用户明确确认,绝不推送也绝不创建 PR。 首先在本地构建并提交。
- 仅自动应用配置文件模板。 README/AGENTS.md/测试/操作手册均为 提案草稿,用户需要审查 — 自动编写散文可能会“记录虚构内容”。
- 绝不将 GitHub 设置变更(如分支保护、密钥扫描、标签)与代码提交捆绑。将这些变更作为
gh命令清单呈现给用户,由用户运行并确认。 - 尊重存在未提交变更的工作区:未经询问,不得使用
--force覆盖未提交的工作。