SuperAPI AI 工具集

zoonk-issue-planning

通用与其它

查看项目

更新于 10-16 07:19

技能介绍

用途:当已有实现方案、希望先创建 GitHub issue 而非立即编码时使用;适合功能过大、需跨多个区域(API、应用、包)协调或需支持并行开发的情况。

主要能力:提供 issue 规模指南(理想约 300 行代码,硬上限 500 行;测试代码、生成代码、PO 文件、锁文件、代码生成的类型定义、注释与文档不计入);识别分层、应用、包、功能、组件等自然边界;分组必须一同交付的变更;按路由、组件、读写操作拆分过大的分组;映射依赖关系并估算规模。

关键规则:规格编号不是 GitHub issue 编号,引用时用文件名而非 #编号;每个新增功能的 issue 必须包含测试,不建单独的测试 issue;验证隐含在每条 issue 中,不建单独的验证 issue;API 工作一个端点(或一小批相关端点)一条 issue。

层级:Epic 描述整体目标,子 issue 描述具体实现。大型实现可用子 Epic 按域分组(如 API、主应用、编辑器),域内有 5 个以上相关 issue 时才建议使用子 Epic。依赖遵循 Schema → API → 前端、共享组件 → 使用页面等模式,不确定时保持不阻塞,避免过度约束。

流程:读方案 → 找自然边界 → 分组相关变更 → 拆分超限分组 → 映射依赖 → 校验规模。输出格式分单 Epic 简洁格式(含子 issue 与依赖图)和多域嵌套格式。

限制:不编写规格(issue 仅含标题和简短描述)、不实际创建 issue(用 zoonk-github-issues)、不估算时间、不分配 issue。

原文未提供具体安装命令或调用方式。