SuperAPI AI 工具集

cs-issue-report

办公与效率

查看项目

更新于 10-15 20:30

技能介绍

用途:在 CodeStable 工作流中起草 Issue 报告,把用户口头描述的问题落成结构化记录,并判定走标准路径还是快速通道。触发场景是提 issue、记录 bug、发现问题;新功能需求应改走 cs-feat。

使用方式:开始前先执行 CodeStable preflight,读 .codestable/attention.md,缺失则先 cs-onboard,不读外部 AI 入口替代。先确认是否为 bug、用 Glob .codestable/issues/ 看有无同类问题,决定新建还是更新。快速通道判定时按线索 Grep/Read 相关代码,若可给出 {文件}:{行号}、修复改动仅 1-2 处且无跨模块风险,提示可走快速通道并触发 cs-issue-fix;否则走标准路径且默认不再改判。与用户商定 slug,目录名用当天日期前缀,不存在则创建。

必答 5 问:逐题询问,不一次性抛出,每题做模糊度检查。依次为问题现象、复现步骤、期望行为与实际行为、环境信息、严重程度与优先级(P0 阻塞/P1 严重/P2 中等/P3 轻微)。严重程度用户不确定时给建议但由用户拍板。

输出:按模板生成报告,frontmatter 含 doc_type: issue-report、issue、status、severity、summary、tags,正文分问题现象、复现步骤、期望 vs 实际、环境信息、严重程度、备注六部分。

限制:只记现象不记根因,用户提出的组件怀疑仅作线索;问题现象须为纯现象描述;期望与实际必须显式分开;复现步骤须可执行,无法稳定复现也要写明触发条件与频率;相关文件未知写“待定”。退出条件是 frontmatter 完整、5 问均有具体答案、现象未混入根因推测、期望与实际分开、复现步骤可执行、用户明确确认可进入下一步、status 改为 confirmed。退出后提示下一阶段触发 cs-issue-analyze,不要自行开始根因分析。原文未提供更完整的模板细节或额外退出后处理。