jackin-goal-prompt
把一条路线图条目(以及操作者交给你的任何计划文件)提炼成单条自包含的 /goal 提示——一个没有任何先前上下文的执行智能体能直接跑到完成的提示。提示即产品;它的紧凑程度决定目标成败。
硬性上限 4000 字符。结构借用 /improve 的计划骨架:自包含、以验证为关卡、边界硬性。承载执行的主干——目标、范围、验证关卡、完成标准、STOP 条件——保留;凡是执行者能从文件读取(代码片段)或从 jackin❯ 自动加载规则(AGENTS.md、COMMITS.md、ENGINEERING.md)继承的内容,一律指向引用,绝不重述。
与 jackin-research 的区别:后者撰写一份档案式简报(多页 prompt.mdx 文件,通过 /goal Follow 运行)。本技能产出紧凑的内联提示,通过 /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 的输出。
流程
- 收集变更。读取路线图 .mdx。只锚定 title: 和 Status: ——真实条目会偏离 Problem/Why/Design/Tasks 脚手架,所以容忍任意标题集合。若给定 --plan,读取每个计划文件并提取其范围、步骤、验证命令、完成标准和 STOP 条件。
当你能用两句话说明这次变更要构建什么、代码在哪里时,即完成。
- 读取仓库真实的验证关卡。验证命令来自仓库,绝不臆造。从 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 profile,以及当改动 docs/ 时的 bun docs 关卡。
当你引用的每个关卡都是仓库实际运行的命令,并附有预期结果时,即完成。
- 撰写提示——压缩版 /improve 骨架:
目标 — 一到两行:要构建什么,来自路线图/计划。
范围 — 范围内的路径;范围外的边界(看起来相关但绝不能触碰的东西)。
验证关卡 — 来自步骤 2 的命令,每条附预期结果。
完成标准 — 机器可检查,每行一条(一条命令 + 结果,或可 grep 的不存在项),绝不写“正常工作”这类散文。
STOP 条件 — 与计划发生偏移、无法维持的范围边界、无法诚实地变绿的关卡。
约定 — 一行指向 jackin❯ 自动加载的规则文件;不要复制其内容。
- 执行 4000 字符上限。把提示写入临时文件并 wc -c 它。超出上限时,按此优先级压缩直到合适:删除代码片段(只写文件名 + 需满足的契约,而非代码)、把约定折叠为指针、收紧目标、删掉“为什么”的叙述、把完成标准并入验证关卡。重新计数。上限是硬的——绝不输出超过 4000。
当 wc -c 报告 ≤ 4000 且提示仍带有目标 + 范围 + 验证关卡 + 完成标准 + STOP 条件时,即完成。
- 输出 + 报告。在单个代码块中打印提示,可直接粘贴到 /goal Implement <slug> 或 /goal Run 之后。说明字符数。指出你为适配而压缩或删掉了什么,以便操作者若愿意提高上限时可要求在行内加回。
常见错误
超过 4000 字符——唯一硬性约束。
臆造验证命令而非读取仓库真实命令——仓库不跑的关卡是噪音。
重述 jackin❯ 自动加载规则(AGENTS.md、COMMITS.md、ENGINEERING.md)——执行者会自动加载它们;指向,别复制。
内联代码片段——执行者会读文件;写出文件名及其必须满足的契约。
产出依赖聊天上下文的提示(“如前所述”“我们选定的方案”)——非自包含,在新执行者上会失败。
给定 --plan 文件却忽略它们——它们承载范围与完成标准;并入它们才是重点。
丢掉 STOP 条件——它们是执行者唯一的诚实逃生口。
工具
没有 xtask 负责此事。该技能编排各类读取(路线图 .mdx、计划文件、仓库验证命令)并输出单个 ≤ 4000 字符的字符串。结构借用 /improve 的计划解剖(自包含、以验证为关卡、边界硬性)以及 jackin❯ 已用于缺口闭合的 /goal Run 简报形态。