propose

提议

将一项功能、改进或问题转化为已跟踪的路线图条目，并创建早期 PR。此技能绝不编写代码——它会收集路线图条目的所有内容、创建 PR，然后停止。实现始终是之后单独进行的步骤（/goal Implement <slug>.md）。

jackin' 规则文件会自动加载——BRANCHING.md、COMMITS.md、PULL_REQUESTS.md、docs/ 规则、TODO.md（路线图约定）。此技能会按顺序执行这些规则。

适用场景

• 操作者运行 /jackin-dev:propose <idea or problem>。
• 值得纳入路线图的功能或想法。

不适用场景

• 小修复（拼写错误、依赖版本升级、一行改动）→ /jackin-dev:create-pr。
• 设计现有条目 → /jackin-dev:brainstorm。实现现有条目 → /goal Implement <slug>.md。

参数

• --branch <name> / --auto-branch — 显式指定 / 自行选择分支名称。
• --no-pr — 仅创建分支和路线图草稿，不创建 PR（少见；默认会创建 PR）。
• --research — 先运行 deep-research，并将简短摘要纳入草稿。

流程

1. 创建分支。 切勿提交到 main。根据想法派生 feature/<slug> 名称（或根据改动类型使用 fix/ / refactor/ / chore/）；除非给定 --auto-branch / --branch，否则先提出分支名并确认。
2. （可选）研究。 使用 --research 时，运行内置的 deep-research 技能，并将研究结果总结到草稿中。对于大型研究，优先使用 /jackin-dev:research。
3. 搭建路线图条目框架。 运行 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。
4. 提交并推送。 使用 docs: 类型和 DCO -s，然后运行 git push。
5. 创建 PR。 除非使用 --no-pr，否则使用 create-pr 的机制创建并打开 PR — Summary = 想法，What ships = "<slug> 的路线图条目草稿"，Verify = 文档渲染。
6. 停止。 告知操作者下一步：运行 /jackin-dev:brainstorm <slug> 填写 ## Design。不要进行实现。

常见错误

• 编写代码或填写 ## Design / ## Tasks — 这些属于 brainstorm / plan / goal，绝不属于 propose。
• 跳过侧边栏条目或审计，导致该条目无法访问。
• 忘记创建早期 PR（这是默认行为——只有 --no-pr 才会跳过）。

工具

cargo xtask change new <slug> --group <group> 会搭建 .mdx 文件框架并登记 Fumadocs meta.json 条目；cargo xtask roadmap audit 会验证侧边栏。