Appearance
如何利用 AI 建立严格的 Issue 验收门禁机制
解决开发中常见的“需求模糊”痛点:通过 AI 强制要求在执行任务前必须创建包含可测试验收标准的 GitHub Issue,否则将任务状态设为草稿并阻塞执行。
为什么需要这个技能
在快速迭代的开发过程中,开发者经常在需求不明确的情况下直接开始编码,导致频繁的返工或验收标准偏差。
本技能为 AI 设定了一套严格的“门禁”逻辑:没有明确且可测试的验收标准 Issue 保持 draft 状态 阻塞执行。它将 GitHub Issue 变成了任务的唯一追踪入口,强制在编码前将“怎么定义完成”达成共识,从而提升交付质量。
适用场景
- 启动一个新的功能实现任务,需要一个标准化的追踪入口时。
- 需要强制要求用户提供可量化、可测试的验收条件,避免模糊需求。
- 需要在任务流中清晰区分
草稿、就绪、阻塞等不同阶段。
核心工作流
- 结构化创建:AI 使用
gh issue create命令创建 Issue,必须包含:问题描述、目标、范围、非目标、验收标准、依赖项及状态。 - 验收标准校验:
- 有效:具体且可验证。例如:“CreateCheckoutLambda-dev 必须返回一个可打开的第三方支付 URL”。
- 无效:模糊描述。例如:“修复结算问题”或“优化用户体验”。
- 状态判定(门禁):
- 若验收标准缺失或不可测试 设置
Status: draft并标注Execution Gate: blocked,停止执行。 - 若验收标准明确 设置
Status: ready并标注Execution Gate: allowed,允许进入执行阶段。
- 若验收标准缺失或不可测试 设置
- 执行移交:只有当门禁状态为
allowed时,AI 才能调用后续的闭环交付工作流。
Issue 模板参考
AI 在创建 Issue 时将遵循以下格式:
md
## Problem
<描述损坏或缺失的功能>
## Goal
<预期达到的结果>
## Scope
- <在范围内的项>
## Non-Goals
- <不在范围内的项>
## Acceptance Criteria
- <明确的、可测试的验收标准 1>
## Dependencies/Blockers
- <依赖项或无>
## Status
draft|ready|blocked|done
## Execution Gate
allowed|blocked (<原因>)下载和安装
下载 create-issue-gate 中文版 Skill ZIP
解压后将目录放入你的 AI 工具 skills 文件夹,重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。
你可能还需要
暂无推荐