用途:issue-prerequisite 是“issue-driven-development”流程的第一步硬性闸门。核心原则是任何任务无论大小都必须有对应的 GitHub Issue,开始前会声明正在检查 Issue。
主要能力:
- 校验:若已提供 Issue,用 gh issue view [ISSUE_NUMBER] --json number,title,state,body 确认存在且可访问,并确认属于正确仓库;不存在或不可访问则报错不继续。
- 无 Issue 时:先扫描项目看板中的 Ready/In Progress 项,若恰好有一个匹配则直接使用;若无匹配,则结合请求与仓库文档(README、FEATURES.md、BRANDING.md、docs、Storybook)新建 Issue;仅在存在多个候选或关键信息确实缺失时才询问用户。
- 新建 Issue:收集标题、描述、验收标准、类型(Feature/Bug/Chore/Research/Spike)、优先级(Critical/High/Medium/Low),用 gh issue create 创建并解析出编号。
- 加入项目看板(强制):gh project item-add,失败则退出;随后获取 ITEM_ID。
- 设置字段(强制):设置 Status、Type、Priority 等单选项字段。
- 校验闸门:重新读取项目项,确认 Status 等字段已设置,否则不继续。
- 质量检查:Issue 需有清晰标题、描述、至少一条可验证验收标准,并已在项目看板中且状态正确。
使用方式:作为技能在开始任何工作前调用;依赖 GitHub CLI(gh)与 jq,并需要环境变量 GITHUB_PROJECT_NUM、GH_PROJECT_OWNER。文中给出的 gh 与 jq 命令保持原样。
适用场景:所有需要变更代码或文档的开发任务,强调记录与可追溯性,反驳“改动太小不需要 Issue”的常见理由,并给出最小可行 Issue 示例。
限制:文档未说明该技能的安装方式、收费、兼容平台或效果数据;未提供时视为暂未提供。所有命令依赖正确配置的 GitHub CLI、项目看板字段(Status/Type/Issue Type/Priority)与权限。