用途:analyze-issue 是一个命令式技能,接收 GitHub issue 编号作为参数($ARGUMENTS),将其分析为一份可落地的技术规格文档,适合在编码前做需求澄清与方案设计。
主要流程:1) 检查 issue 是否已加载,查找 ./specs/issues/ 下按“三位补零编号-短横线标题.md”命名的文件;2) 未找到则读取 .claude/commands/load-issues.md 了解拉取方式,并按该格式保存 issue 文件;3) 理解需求、审阅相关代码与项目结构;4) 生成技术规格。
规格内容:包含 Issue Summary(标题、描述、标签、优先级)、Problem Statement、Technical Approach、Implementation Plan(分步骤)、Test Plan(单元、组件、集成测试场景)、Files to Modify、Files to Create、Existing Utilities to Leverage、Success Criteria、Out of Scope。
输出与约定:完成后将完整规格保存为 ./specs/issues/<三位编号>-<短横线标题>.specs.md(示例:issue #7 保存为 007-make-code-review-trigger-on-sql-sh-changes.specs.md),并向用户简要汇报 issue 编号与标题、保存路径及 2-3 条关键要点。需遵循严格 TDD 原则、KISS 方法与单文件 300 行上限。
适用场景:需要在动手实现前把 issue 转成技术方案、拆解实现步骤和测试计划的开发工作流。
限制:技能资料未说明具体支持的模型、依赖环境、是否收费及平台支持,暂未提供;GitHub 拉取细节依赖外部 load-issues.md 文件,格式与鉴权方式暂未提供。