用途:这是一套 Issue 质量工具,围绕 GitHub Issue 的规范化与可执行性,提供 lint、enrich、decompose 三个子命令,覆盖评分、补全和拆分三类需求。
主要能力:
- /issue lint [#N|--all]:按组织标准评分量表给 Issue 打分。读取 groom/references/org-standards.md 获取评分标准,用 gh issue view N --json title,body,labels,milestone 拉取 Issue,按章节打分(总分 0-100),并把问题分为错误(阻断)与警告(提示)后报告分数与发现。评分项包括验收标准 25 分、问题描述 20 分、受影响文件 15 分、验证方式 15 分、标签 10 分、工作量 5 分、图表 5 分、里程碑 5 分。错误包括缺少优先级标签、无验收标准、无问题陈述、代码变更类 Issue 缺少受影响文件;警告包括无图表、无工作量标签、无验证命令、无边界说明、无里程碑。--all 模式对所有开放 Issue 打分并输出汇总表;--fix 模式在打分后对低于 70 分的 Issue 执行 enrich。
- /issue enrich [#N]:通过子代理研究补全缺失章节:受影响文件、验证方式、验收标准、方案、上下文、图表分别由对应代理生成,随后重写 Issue 正文、补充缺失标签,并重新 lint 以确认分数不低于 70。更新使用 gh issue edit 命令。
- /issue decompose [#N]:把过大的 Issue 拆分为原子子 Issue。适用于带 effort/xl 标签、跨 3 个以上目录 5 个以上文件、验收标准横跨多个关注点、或混合功能与重构的情况。流程包括拉取评论、分析范围、识别自然边界、创建子 Issue(引用父 Issue、独立验收标准与受影响文件、依赖链接、继承优先级与领域标签、合适的工作量标签),并把父 Issue 转为 epic、添加 checklist、移除 effort/xl。
使用方式:以斜杠命令形式调用,依赖 gh CLI 与 GitHub 仓库上下文。
适用场景:在开发流程中作为 Issue 质量门禁,例如在 groom、autopilot、tidy 等流程中调用。
限制:评分规则依赖 groom/references/org-standards.md,拆分与补全依赖子代理与仓库文档(如 .glance.md、CODEBASE_MAP.md、project.md)。具体平台支持与收费情况暂未提供。