mcpField
A
analyze-issue

analyze-issue

github.com/neolabhq开发1.8k1.2k 次安装9 周前更新
代码仓库

关于 analyze-issue

用于分析 GitHub issue 并编写技术规格的 Claude 命令。它指导加载 issue 信息、检查相关代码，并将结构化规格保存到 `./specs/issues/`。

主要功能

  1. 01检查是否已有 issue 文件
  2. 02按项目说明获取 issue 详情
  3. 03审查需求与相关代码
  4. 04生成结构化技术规格
  5. 05将规格保存到 issues 目录

适用场景

  1. 01将 GitHub issue 转为实施计划
  2. 02记录需修改或新增的文件
  3. 03制定测试计划与成功标准

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/neolabhq/context-engineering-kit --skill analyze-issue

安装后在 Claude Code 中输入/analyze-issue确认已加载。

详细介绍

请分析 GitHub Issue #$ARGUMENTS，并创建一份技术规范。

请按以下步骤操作：

  1. 检查 Issue 是否已加载：

    • 在 ./specs/issues/ 文件夹中查找 Issue 文件
    • 文件命名格式：<补齐至 3 位的编号>-<kebab-case 标题>.md
    • 如果未找到，请从 GitHub 获取 Issue 详情（见第 2 步）

  2. 获取 Issue 详情（如果尚未加载）：

    • 阅读 .claude/commands/load-issues.md，了解如何获取 Issue 详情
    • 按照 load-issues.md 中的格式保存 Issue 文件

  3. 彻底了解需求

  4. 检查相关代码和项目结构

  5. 按照以下格式创建技术规范

Issue #$ARGUMENTS 的技术规范

Issue 摘要

  • 标题：[GitHub Issue 标题]
  • 描述：[Issue 的简要描述]
  • 标签：[Issue 的标签]
  • 优先级：[根据 Issue 内容确定高/中/低]

问题陈述

[用 1-2 段说明问题]

技术方案

[详细的技术方案]

实施计划

  1. [步骤 1]
  2. [步骤 2]
  3. [步骤 3]

测试计划

  1. 单元测试：
    • [测试场景]
  2. 组件测试：
    • [测试场景]
  3. 集成测试：
    • [测试场景]

要修改的文件

  • [文件路径]：[变更内容]

要创建的文件

  • [文件路径]：[用途]

可复用的现有工具

  • [工具名称/路径]：[用途]

成功标准

  • [标准 1]
  • [标准 2]

范围之外

  • [项目 1]
  • [项目 2]

请务必遵循严格的 TDD 原则、KISS 方法和 300 行文件限制。

重要：完成分析后，将完整的技术规范保存到： ./specs/issues/<补齐至 3 位的编号>-<kebab-case 标题>.specs.md

例如，对于标题为“在任何 *.SQL 和 .sh 文件变更时触发代码审查”的 Issue #7，保存到： ./specs/issues/007-make-code-review-trigger-on-sql-sh-changes.specs.md

保存后，请向用户提供简要总结，确认：

  • 已分析的 Issue 编号和标题
  • 规范的保存路径
  • 规范的主要内容摘要（2-3 个要点）

评论

支持 Markdown