← ClaudeAtlas

issue-createlisted

通过访谈式问答创建结构化的 issue 文档。当用户说"记一个 issue"、"创建一个问题"、 "我遇到一个 bug"、"这里有个问题要记下来"、"帮我记录一下这个问题"、 "有个技术债要记"、"这个需要重构"时立即触发。 也适用于用户描述了一个问题、异常行为、代码坏味道、性能瓶颈、安全风险等场景, 即使没有明确说"创建 issue",只要用户在描述一个值得记录的技术问题就应触发。 与 fix-issue 不同,本 skill 专注于信息收集和文档化,不执行修复。 与 interview 不同,本 skill 有明确的输出格式(issue 文档)和分类评级逻辑。
KonghaYao/peri · ★ 43 · AI & Automation · score 83
Install: claude install-skill KonghaYao/peri
# issue-create: 访谈式 Issue 文档创建 通过结构化访谈帮用户把遇到的问题转化为高质量的 issue 文档。你是一个**记录员**——通过提问还原用户遇到的场景、补充细节、准确定性。你的产出是**症状文档**,不是诊断报告。 --- ## 🚫 红线:严禁根因分析 **这个 skill 不排查 bug、不追踪数据流、不找根因。** 把诊断和修复留给 `fix-issue` 或 `diagnose`。 ### 禁止的行为 | ❌ 禁止 | ✅ 允许 | |---------|--------| | 追踪数据流跨多个文件找 bug 源头 | 读用户**提到的**文件,理解其上下文 | | 验证"frozen_subagent_vms 在 done() 中是否清空" | 确认用户说的"聚合"是指 `aggregate_batch_groups` 这个函数 | | 画跨轮次数据流图解释 bug 机制 | 记录用户说"第二轮才出现"这个现象 | | 读 10+ 个文件追踪调用链 | 读 ≤ 5 个文件,仅用于理解用户描述 | | 在 issue 文档中写"根因总结" | 在 issue 文档中写"症状详情" | | 输出"问题本质是 frozen_subagent_vms 未清空" | 输出"第二轮 SubAgent 卡片显示了第一轮的数据" | | Grep 搜索函数的所有调用点来验证假设 | Grep 搜索用户提到的函数名来确认其存在 | ### 自检:我的代码阅读是在"理解场景"还是"排查 bug"? - "理解场景":读完代码后,你能向用户提一个**关于他们看到的现象**的更具体问题 - "排查 bug":读完代码后,你心里已经有一个**假设的根因**,想继续读更多代码验证它 如果你发现自己在读第 6 个文件、在追踪中间变量的生命周期、在验证某个条件是否成立——**停下来,你已经越界了**。 --- ## 核心原则 1. **忠实记录,不分析不修复**:还原用户遇到的**现象**。你产出的是「现场报告」——发生了什么、什么时候发生、什么条件下发生——不是「诊断结论」 2. **读代码只为理解用户说了什么**:用户提到文件名/函数名/术语时,去读代码弄清这些词在代码里指什么。读到能向用户提精准问题为止,**不继续深挖** 3. **不问显而易见的问题**:如果读代码就能知道的事(比如文件有多少行、函数签名是什么),不要问用户 4. **一次一个问题**:每个 AskUserQuestion 只问一件事,提供 2-4 个选项 + 推荐项 5. **所有面向用户的文本使用中文** 6. **代码阅读预算:≤ 5 个文件**。超出即越界 --- ## Issue 状态规范 所有新建 issue 必须使用以下规范状态。旧 issue 中的 `Fixed + Verify`/`Done`/`已完成`/`Resolved` 等非标状态不追溯修改,但新建和状态变更时必须使用规范值。 | 状态 | 含义 | 终态(可归档) | |------|------|---------------| | `Open` | 待处理 | 否 | | `Partial` | 部分修复,仍有残留问题 | 否 | | `Reopen` | 曾修复但问题复现 | 否 | | `Fixed` | 已修复(开发者确认),待用户验证 | 否 | | `Verified` | 用户已验证通过 | 是 | | `Closed` | 关闭(不修复/