Skip to content

如何利用 AI 建立严格的 Issue 验收门禁机制

解决开发中常见的“需求模糊”痛点:通过 AI 强制要求在执行任务前必须创建包含可测试验收标准的 GitHub Issue,否则将任务状态设为草稿并阻塞执行。

为什么需要这个技能

在快速迭代的开发过程中,开发者经常在需求不明确的情况下直接开始编码,导致频繁的返工或验收标准偏差。

本技能为 AI 设定了一套严格的“门禁”逻辑:没有明确且可测试的验收标准 Issue 保持 draft 状态 阻塞执行。它将 GitHub Issue 变成了任务的唯一追踪入口,强制在编码前将“怎么定义完成”达成共识,从而提升交付质量。

适用场景

  • 启动一个新的功能实现任务,需要一个标准化的追踪入口时。
  • 需要强制要求用户提供可量化、可测试的验收条件,避免模糊需求。
  • 需要在任务流中清晰区分 草稿就绪阻塞 等不同阶段。

核心工作流

  1. 结构化创建:AI 使用 gh issue create 命令创建 Issue,必须包含:问题描述、目标、范围、非目标、验收标准、依赖项及状态。
  2. 验收标准校验
    • 有效:具体且可验证。例如:“CreateCheckoutLambda-dev 必须返回一个可打开的第三方支付 URL”。
    • 无效:模糊描述。例如:“修复结算问题”或“优化用户体验”。
  3. 状态判定(门禁)
    • 若验收标准缺失或不可测试 设置 Status: draft 并标注 Execution Gate: blocked,停止执行。
    • 若验收标准明确 设置 Status: ready 并标注 Execution Gate: allowed,允许进入执行阶段。
  4. 执行移交:只有当门禁状态为 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

你可能还需要

暂无推荐