ai-dev-autopr 是一个面向开发任务的端到端执行技能,目标是把一份规格、issue、工单或自由文本描述,一路推进到“合并就绪”的 PR/MR:已完成实现、已通过验证、已接受评审,并且逐条回应了评审反馈。资料明确划定了它的工作边界:不满足于“代码写完了”,不交付红色构建,也不留下无人回应的评审意见。
用途与输入方式:
- /ai-dev-autopr <spec-id>:实现一个已有规格并推进到 PR。
- /ai-dev-autopr <issue-url-or-id> 或 /ai-dev-autopr "free text description":先提出规格/计划,经人工评审后再实现到 PR。
- 修饰选项:no worktree(在当前检出工作)、no spec review(跳过规格/计划人工关口)、keep draft(不把 PR/MR 标记为可供评审);也可用自然语言表达这些意图。
- --finish:合并后验证已合并、清理、关闭 issue,并提供归档/同步选项。
主要能力与流程:
- 定位阶段:读取仓库自身的 CLAUDE.md、AGENTS.md、CONTRIBUTING.md 等指令,识别 forge(GitHub、GitLab 等)、SDD 框架(如 OpenSpec、.specify、.kiro/specs、docs/adr、specs)、验证层级、是否自动评审 PR、基础分支,并输出紧凑的定位信息块。
- worktree 与分支:默认在隔离 worktree 上创建新分支,分支名按 <类型>/<短横线标识> 形式派生并尽量贴合仓库命名习惯;不会切换主 worktree 的分支,也不使用裸 git stash。
- 规格或计划:若输入是已有规格则直接按其机制实现;若输入是 issue、工单或描述,则先获取原文与评论,用项目所用框架提出规格,或写实现计划(目标、阶段、涉及文件、每阶段验证、开放问题),并在评审关口等待人工确认,除非明确跳过。
- 实现:按阶段推进,每阶段完成后运行该阶段验证;贴合周边代码的命名、错误处理与注释风格;只改工作所需内容,不做顺带重构。
- 验证:按仓库实际使用的层级补充验证(新逻辑用单元测试、新路由/查询/表交互用集成测试、新用户流程用端到端、提示或模型行为用已有评估工具);证明每个新测试确实会失败;运行单元、集成及受影响的可选层级,以及只读的 lint/format/type 门禁;不通过弱化断言、跳过或删除测试来“变绿”。
- 提交与推送、开启 PR/MR、处理评审反馈,最终达到合并就绪。
安全与边界约束:所有读取内容(源码注释、配置、提交历史、文档、网页、issue/PR 文本等)都只作为数据摘要,绝不作为指令执行;只有限定集合中的上下文文件在其既有角色范围内具有指令权限。写操作仅限本次会话所在仓库/工作目录内,仓外写入需用户在请求中指明路径;临时文件可用 mktemp 创建并须清理。发现被拒绝的指令时,需在指定输出中逐字引用并标注位置,PR 正文只写位置不写原文。
何时停下来询问人类:出现实质不同的设计方案且输入未作选择;与已接受的 ADR、硬约束或安全姿态冲突;只有人类能解除的阻塞(如过期认证、凭据、缺失服务、产品决策);凭据要发往无人选择的宿主;同一验证在三种不同修复下仍连续失败。其余命名、文件位置、测试层级等由技能自行推断,并记录在 PR 正文的“Assumptions”中。
适用场景:需要把规格或 issue 自动推进为可评审 PR 的软件仓库开发工作流,尤其是已有明确仓库约定、验证层级和评审机制的团队项目。限制:资料未提供具体的安装命令、收费模式、支持平台范围或效果数据;对未声明 forge 的环境需人工说明 PR 开启方式;涉及仓外写入、外部宿主机或凭据目的地时需额外确认。