jackin-goal-prompt

jackin-goal-prompt

将路线图条目（以及操作者提供的任何计划文件）提炼为一个自包含的 /goal 提示词——零上下文的执行 Agent 也能据此从头执行到完成。提示词就是最终产物；其精简程度决定了目标能否成功。

硬性上限为 4000 个字符。结构借鉴 /improve 的计划：自包含、以验证为门槛、边界明确。承载执行的骨架——目标、范围、验证门槛、完成标准、STOP 条件——必须保留；执行者可以从文件中读取的内容（代码片段），或从 jackin❯ 自动加载规则（AGENTS.md、COMMITS.md、ENGINEERING.md）中继承的内容，只需指向，不要复述。

这与 jackin-research 不同：后者撰写的是研究简报（通过 /goal Follow 运行的多页 prompt.mdx 文件）。本工具生成的是紧凑的内联提示词，通过 /goal Implement 或 /goal Run 运行。

适用场景

• 操作者要求编写目标提示词，或想针对某个路线图条目启动 /goal。
• 操作者提供了路线图条目和 /improve 计划文件，希望将它们合并为一个可直接运行的提示词。

不适用场景

• 撰写研究简报 → jackin-research。
• 设计路线图条目本身 → jackin-brainstorm。
• 创建 PR → jackin-create-pr / jackin-propose。

参数

• <slug> — 路线图条目（slug、路径或 .mdx 文件）。始终必需。
• --plan <path|glob> — 要合并的计划 Markdown（文件夹、文件或 glob）。通常是 /improve 的输出。

流程

1. 收集变更信息。 阅读路线图 .mdx。仅以 title: 和 **Status**: 为锚点——实际条目经常偏离 Problem/Why/Design/Tasks 框架，因此要兼容任意标题。如果提供了 --plan，读取每个计划文件，提取其范围、步骤、验证命令、完成标准和 STOP 条件。

   完成标准：能够用两句话说明此变更要构建什么，以及代码位于何处。

2. 读取仓库实际的验证门槛。 验证命令必须来自仓库，不能自行编造。从 CONTRIBUTING.md（合并就绪部分）、.github/workflows/ci.yml 和 mise.toml 中提取——对于 jackin❯，这些命令是 cargo fmt --check、cargo clippy --all-targets --all-features -- -D warnings、cargo nextest run --all-features、e2e 配置，以及触及 docs/ 时的 bun 文档门槛。

   完成标准：引用的每个门槛都是仓库实际运行的命令，并注明预期结果。

3. 编写提示词——压缩后的 /improve 框架：

   • 目标——一至两行：要构建什么，内容取自路线图/计划。
   • 范围——范围内的路径；范围外的边界（看似相关但不得触碰的内容）。
   • 验证门槛——第 2 步中的命令，并分别注明预期结果。
   • 完成标准——每项一行、可由机器检查（命令及结果，或可通过 grep 检查的内容缺失）；不要写“正常工作”之类的描述。
   • STOP 条件——偏离计划、无法守住范围边界、无法如实通过验证门槛。
   • 约定——用一行指向 jackin❯ 自动加载的规则文件；不要复制其内容。

4. 确保不超过 4000 个字符。 将提示词写入临时文件并运行 wc -c。若超过上限，按以下优先级压缩，直到符合要求：删除代码片段（注明文件和约定，而非代码），将约定精简为指向规则文件，缩短目标，删去“原因”说明，将完成标准合并到验证门槛中。然后重新计数。上限不可逾越——绝不输出超过 4000 个字符的内容。

   完成标准：wc -c 显示 ≤ 4000，且提示词仍包含目标 + 范围 + 验证门槛 + 完成标准 + STOP 条件。

5. 输出并报告。 将提示词放在单个代码块中打印，确保可直接粘贴到 /goal Implement <slug> 或 /goal Run 后。注明字符数。说明为了符合上限而压缩或删去了哪些内容，以便操作者需要时可以要求将其补回，并提高上限。

常见错误

• 超过 4000 个字符——这是唯一的硬性限制。
• 不读取仓库中实际的验证命令，凭空编造命令——仓库不会运行的门槛只会制造噪音。
• 重述 jackin❯ 自动加载的规则（AGENTS.md、COMMITS.md、ENGINEERING.md）——执行器会自动加载这些规则；指出文件即可，不要照抄。
• 直接内嵌代码片段——执行器会读取文件；写明文件名及其必须满足的约定。
• 编写依赖聊天上下文的提示词（例如“如前所述”“我们选择的方法”）——内容不完整，在全新的执行器上会失效。
• 忽略收到的 --plan 文件——这些文件包含范围和完成标准；整合进去正是目的。
• 删除 STOP 条件——它们是执行器唯一可靠的退出途径。

工具

没有 xtask 负责这项工作。该技能负责协调读取（路线图 .mdx、计划文件、仓库的验证命令），并生成一个不超过 4000 个字符的字符串。其结构借鉴了 /improve 的计划框架（内容完整、验证门控、边界明确），以及 jackin❯ 已用于差距弥补的 /goal Run 简报格式。