Community写作与编辑github.com

tjboudreaux/ready-agent-1

准备好让AI智能体接管你的代码仓库了吗?评估代码库的智能体就绪度(确定性、可引用、1-5级),并打通所有关卡。

ready-agent-1 是什么?

Agent Readiness Fix 技能旨在通过执行仅限安全变动的操作,系统性提升代码仓库对AI智能体的友好度(Agent Readiness)。该技能将所需变更划分为三个安全级别不同的板块:自动应用(Auto-apply,即配置文件模板变更)、提案(Propose,即需要人工审核的草稿)和GitHub设置(需手动操作)。它首先确保存在最新的就绪度报告(`.agents/readiness/latest.json`),然后通过`cli.py fix`命令生成变更计划并执行。核心工作流包括:在本地创建专用分支、自动应用安全的配置文件模板(幂等操作,不会覆盖非空文件)、提示用户自行撰写README/AGENTS.md/测试/runbook等散文内容,并最终提交本地commit。该技能明确禁止直接push或创建PR,禁止将GitHub设置与代码变更捆绑,并在工作区存在未提交变更时要求用户确认。支持平台为任何可以通过命令行工具`python3`和`git`操作的代码仓库(如Claude Code命令行环境)。其价值在于为AI智能体使用者提供了一种确定性、低风险的方式来标准化代码仓库结构,从而提升AI智能体的理解和操作效率。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add tjboudreaux/ready-agent-1

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Agent Readiness Fix

通过仅应用安全变更来提升仓库就绪度。引擎会规划并编写配置模板;你负责处理 git 和撰写任何散文内容。三个板块,三种不同的安全级别。

步骤

  1. 确保报告存在。 如果缺少 .agents/readiness/latest.json,请先运行 ra1-report 技能。

  2. 对计划进行试运行,查看将发生哪些变更:

    python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <repo-path>
    

    它会打印出三个板块:自动应用(安全的配置模板)、提案(待审查的草稿)、GitHub 设置(手动操作)。

  3. 首先创建本地分支(绝不要在默认分支上工作):

    git -C <repo-path> checkout -b readiness/fixes
    
  4. 应用安全模板(幂等操作;如果工作区有未提交的变更则拒绝执行;绝不覆盖非空文件):

    python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <repo-path> --apply
    
  5. 自行撰写“提案”项目 — 如 README 章节、定制的 AGENTS.md、操作手册、首个测试。请将这些内容编写成供用户审查的草稿;不要编造与代码库无关的内容。templates/AGENTS.md 是一个起始框架 — 请根据仓库的实际内容进行填充。

  6. 显示差异并本地提交。 总结变更内容,然后:

    git -C <repo-path> add -A && git -C <repo-path> commit -m "chore: raise agent readiness"
    

    在提交消息末尾添加必需的 Co-Authored-By 尾部信息。

  7. 重新运行 ra1-report,以查看就绪度级别的变化。

约定(不得违反)

  • 未经用户明确确认,绝不推送也绝不创建 PR。 首先在本地构建并提交。
  • 仅自动应用配置文件模板。 README/AGENTS.md/测试/操作手册均为 提案草稿,用户需要审查 — 自动编写散文可能会“记录虚构内容”。
  • 绝不将 GitHub 设置变更(如分支保护、密钥扫描、标签)与代码提交捆绑。将这些变更作为 gh 命令清单呈现给用户,由用户运行并确认。
  • 尊重存在未提交变更的工作区:未经询问,不得使用 --force 覆盖未提交的工作。

相关技能