SuperAPI AI 工具集

propose

写作与研究

查看项目

更新于 10-15 22:39

技能介绍

用途:将功能、改进或问题转化为可跟踪的路线图条目,并提前创建 PR。该技能从不写代码,只收集路线图条目所需内容、打开 PR 后停止;实现始终是后续独立步骤(/goal Implement <slug>.md)。

主要能力:自动加载 jackin' 规则文件(BRANCHING.md、COMMITS.md、PULL_REQUESTS.md、docs/ 规则、TODO.md 路线图约定)并按顺序执行;创建分支、可选研究、脚手架路线图条目、提交推送、打开 PR。

使用方式:操作者运行 /jackin-dev:propose <idea or problem>。参数:--branch <name> / --auto-branch 指定或自动选择分支名;--no-pr 仅创建分支与路线图草稿、不开 PR(默认开 PR);--research 先运行 deep-research 并把简短摘要并入草稿。流程:从想法派生 feature/<slug>(或按变更类型用 fix/、refactor/、chore/)分支名并确认;运行 cargo xtask change new <slug> --group <group> 生成 docs/content/docs/roadmap/<slug>.mdx(含 Status: Open、## Problem、## Why It Matters、## Design、## Tasks、## Related Files)并注册到所选组的 Fumadocs meta.json;填写 Problem / Why It Matters;运行 cargo xtask roadmap audit;以 docs: 类型、DCO -s 提交并 git push;用 create-pr 机制打开 PR(Summary 为想法,What ships 为 roadmap item draft for <slug>,Verify 为 docs render);最后指向下一步 /jackin-dev:brainstorm <slug>。

适用场景:值得建立路线图条目的功能或想法。不适用:小修复(拼写、依赖升级、一行改动)用 /jackin-dev:create-pr;设计已有条目用 /jackin-dev:brainstorm;实现用 /goal Implement <slug>.md。

限制与常见错误:不得写代码或填写 ## Design / ## Tasks;不要跳过侧边栏条目或 audit,否则条目不可达;不要忘记默认的提前 PR(仅 --no-pr 跳过)。