SuperAPI AI 工具集

jackin-propose

通用与其它

查看项目

更新于 10-15 22:39

技能介绍

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

主要能力:自动加载 jackin❯ 规则文件(BRANCHING.md、COMMITS.md、PULL_REQUESTS.md、docs/ 规则、TODO.md 路线图约定)并按顺序执行。支持参数:--branch <name> / --auto-branch 指定或自动选择分支名;--no-pr 仅创建分支与路线图草稿、不建 PR(默认会建 PR);--research 先运行 deep-research 并把简短摘要并入草稿。

使用方式:操作者运行 jackin-propose <idea or problem>。流程为:创建分支(绝不提交到 main,按变更类型派生 feature/<slug> 或 fix/、refactor/、chore/ 名称,除非指定 --auto-branch/--branch 否则建议并确认);可选研究;用 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,从现有路线图组中选择 --group,填写 Problem/Why It Matters,运行 cargo xtask roadmap audit;提交并推送(docs: 类型、DCO -s、git push);除非 --no-pr,否则按 create-pr 机制打开 PR(Summary 为想法,What ships 为 roadmap item draft for <slug>,Verify 为 docs render);停止并提示下一步 jackin-brainstorm <slug> 填写 ## Design。

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

限制与常见错误:不写代码、不填写 ## Design / ## Tasks;不要跳过侧边栏条目或审计,否则条目不可达;不要忘记默认会创建早期 PR(仅 --no-pr 跳过)。