GitHub问题分析技能Skill analyze-issue

---

name: 分析问题 description: 分析一个GitHub问题并在.ai/目录中创建详细分析 argument-hint: <问题编号> allowed-tools: Read, Grep, Glob, Write, Bash, mcp__github__get_issue

分析问题

执行GitHub问题的详细分析，并将分析写入.ai目录。

指令

1. 获取问题详情

   • 从gittower/git-flow-next获取问题#$ARGUMENTS
   • 提取：标题、描述、标签、任何链接的问题

2. 创建工作流目录

   • 创建 .ai/issue-<编号>-<slug>/
   • Slug：标题关键字的全小写、连字符版本（最多4个词）
   • 示例：问题 #42 “添加压扁合并支持” → .ai/issue-42-压扁-合并/

3. 探索代码库

   • 搜索相关代码、文件和模式
   • 识别受影响的组件
   • 理解当前实现
   • 在代码库中查找类似模式或先前工作

4. 编写分析文档

   • 在工作流文件夹中创建 analysis.md
   • 使用以下模板

5. 提议TODO注释

   • 如果特定代码位置需要关注，建议TODO注释
   • 格式：// TODO(#<问题>): <描述>

分析模板

写入 .ai/issue-<编号>-<slug>/analysis.md:

# 问题 #<编号>: <标题>

## 摘要
<1-2句话总结问题>

## 问题详情
- **类型**: <错误/增强/功能>
- **标签**: <来自GitHub的标签>
- **链接**: <GitHub问题URL>

## 分析

### 理解
<正在请求/报告什么？澄清任何歧义>

### 根因（对于错误）
<是什么导致这种行为？包括文件:行引用>

### 受影响的组件
列出所有需要更改的文件/包：

- `cmd/<文件>.go` - <为什么这个文件受影响>
- `internal/<包>/<文件>.go` - <为什么>

### 当前行为
<系统在此区域当前如何工作？>

### 提议的解决方案
<解决此问题的高层方法>

### 实施方法
<更详细的技术方法>

1. <步骤1>
2. <步骤2>
3. <步骤3>

### 边缘情况
- <边缘情况1及其处理方法>
- <边缘情况2及其处理方法>

### 测试考虑
基于TESTING_GUIDELINES.md:
- <测试案例1>
- <测试案例2>

### 文档影响
- [ ] 是否需要手册更新？
- [ ] 是否需要CONFIGURATION.md更新？
- [ ] 是否需要README更改？

### 相关代码引用
<相关的关键代码片段或文件:行引用>

## 开放问题
- [ ] <需要向问题作者澄清的任何事项>

## 下一步
1. 创建特性分支：`git flow feature start <编号>-<slug>`
2. 创建实施计划：`/create-plan`

6. 报告完成
   • 显示已创建分析文件的路径
   • 总结关键发现
   • 建议下一步：创建特性分支并运行 /create-plan