用途
Create Issue Gate 是一个问题门禁工作流技能,适用于开始新的实现任务、并且需要以 GitHub Issue 作为必需跟踪入口的场景。它用于在执行前区分草稿、就绪和阻塞状态的工作,确保依赖执行的任务具备有效的验收标准。
该技能仅在用户或当前项目明确要求时使用,并非实现任务的通用前置条件,也不代表创建公开 Issue 的权限。
主要能力
- 定义每个 Issue 必须包含的字段:Problem(问题)、Goal(目标)、Scope(范围)、Non-Goals(非目标)、Acceptance Criteria(验收标准)、Dependencies/Blockers(依赖/阻塞项)、Status(状态:draft | ready | blocked | done)。
- 验收标准门禁:验收标准只有在可测试、可通过/失败检查时才有效。例如有效标准为“CreateCheckoutLambda-dev returns an openable third-party payment checkout URL”,无效标准为“fix checkout”“improve UX”“make it better”。
- 当验收标准缺失或不可测试时:准备可审查的草稿;仅在获得仓库操作授权时创建公开 Issue;设置 Status: draft;添加 Execution Gate: blocked (missing valid acceptance criteria);不将任务推进到执行阶段。
- 状态规则:draft 表示验收标准缺失/薄弱或任务定义不完整;ready 表示验收标准明确且可测试;blocked 表示外部依赖阻止进展;done 表示验收标准已通过证据验证。没有有效验收标准时,绝不将 Issue 标记为 ready。
- 交接执行:执行工作流(例如 closed-loop-delivery)只有在 Issue 状态为 ready 且执行门禁为 allowed 时才能开始。
使用方式
默认准备精确的 Issue 正文以供审查。如果获得 Issue 创建授权,使用指定的仓库和现有模板;技能调用本身不授予向无关仓库发布内容的权限。
Issue 正文模板示例:
Problem
<what is broken or missing>
Goal
<what outcome is expected>
Scope
- <in scope item>
Non-Goals
- <out of scope item>
Acceptance Criteria
- <explicit, testable criterion 1>
Dependencies/Blockers
- <dependency or none>
Status
draft|ready|blocked|done
Execution Gate
allowed|blocked (<reason>)
当可能时,从可用的授权任务上下文中推导验收标准;只有不可或缺且未解决的决策才需要澄清。如果因缺少不可或缺的决策而导致必需的 Issue 仍为 draft,则暂停该依赖步骤,继续独立的安全工作。不要重复询问用户请求中已经明确的验收标准。
适用场景
- 开始新的实现任务,并希望以 GitHub Issue 作为必需的跟踪入口。
- 工作必须被阻塞,直到用户提供明确、可测试的验收标准。
- 需要在执行开始前区分草稿、就绪和阻塞的工作。
限制
仅当任务明确匹配上述范围时使用此技能。不要将输出视为环境特定验证、测试或专家审查的替代品。如果缺少必需的输入、权限、安全边界或成功标准,应停止并请求澄清。