SuperAPI AI 工具集

roadmap

办公与效率

查看项目

更新于 10-16 01:10

技能介绍

用途:在 GitHub 仓库中管理项目路线图,让 ROADMAP.md 与 GitHub 上的 Issues、标签、里程碑保持一致,并辅助规划与创意讨论。

前置条件:需要可用的 GitHub CLI。检查命令为 gh --version 2>/dev/null && gh auth status 2>/dev/null;未安装时引导至 https://cli.github.com,未认证时运行 gh auth login。未满足条件不应继续。

核心原则:CONTEXT.md 被视为项目宪法,所有模式都需先读取并遵守其中边界;若建议会越界,需明确指出违反的边界、说明原因并给出替代方案。

模式:不指定参数时默认 sync。sync 拉取开放/近期关闭的 Issues 与里程碑,读取 ROADMAP.md 和 CONTEXT.md,检测不一致(已完成仍开放、已关闭仍开放、缺失等),更新文件并把已关闭项移入 Completed Milestones 的季度子标题,按 references/label-config.md 的启发式为缺少 effort/* 标签的开放 Issue 估算工作量,同步 GitHub 标签(roadmap/),在 Issue 行追加 [S]/[M]/[L] 标记,并生成 3-5 条优先级建议。generate 用于从零引导 CONTEXT.md 与 ROADMAP.md:若文件已存在会询问重新生成、合并或中止;随后调研代码库、推断项目边界、外部调研、起草 CONTEXT.md,再抓取 Issues 与里程碑并分类、估算 LOE、应用 effort/ 标签、起草 ROADMAP.md,先写 CONTEXT.md 再写 ROADMAP.md,并对两者运行 markdownlint。brainstorm 为协作式创意讨论,默认只读,未经用户明确批准不创建 Issue 或修改 ROADMAP.md;会读取现状与边界、调研代码库扩展点、外部趋势,用提问技巧产生想法,并按描述、理由、边界检查、工作量、影响、下一步的结构呈现,最后询问哪些想法需要落地。status 为只读快速摘要,展示整体指标及按类别(enhancement/bug/docs)和按 LOE(small/medium/large)的表格,并标记明显不一致。help 显示模式、标签映射(roadmap/current→Immediate Focus、roadmap/next→Near-Term Vision、roadmap/future→Future Vision;effort/small 约 1-2 小时、effort/medium 半天到 1 天、effort/large 多天)与关键原则。

输出规范:结构化对比用表格,emoji 仅用于状态指示,引用 Issue 时始终带编号,任何文件修改后运行 markdownlint。

限制:依赖 GitHub CLI 与认证;brainstorm 默认只读;generate 覆盖前需确认;LOE 为启发式估算;详细流程见 references/sync.md、generate.md、brainstorm.md、status.md、label-config.md。