大模型应用
把路线图条目和计划文件压缩成自包含 /goal…
当需要把某个路线图条目(可附带 /improve 计划文件)转成一段可直接交给零上下文执行代理运行的 /goal 提示词时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
把路线图条目和计划文件压缩成自包含 /g特定
解决思路
- 读取路线图 .mdx,只锚定 title: 和 **Status**:,容忍任意标题结构(真实条目常偏离 Problem/Why/Design/Tasks 模板);若给了 --plan,读取每个计划文件,提取其 scope、steps、verify 命令、done criteria 和 STOP 条件。完成标准:能用两句话说明这次改动要构建什么、代码在哪里。
- 从仓库真实来源读取验证门禁,绝不臆造:CONTRIBUTING.md(merge-readiness 块)、.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 文档门禁。完成标准:引用的每个门禁都是仓库实际运行的命令,并带预期结果。
- 按压缩版 /improve 骨架撰写提示词:Objective(一两行,说明构建什么,取自路线图/计划);Scope(in-scope 路径;out-of-scope 边界,即看似相关但不得触碰的部分);Verify gates(第 2 步的命令,各带预期结果);Done criteria(可机器检查,每行一条:命令+结果,或可 grep 的缺失,绝不写“works correctly”这类散文);STOP conditions(与计划漂移、scope 边界守不住、门禁无法诚实变绿);Conventions(一行指向 jackin❯ 自动加载的规则文件,不要复制其内容)。
- 强制 4000 字符上限:把提示词写入临时文件并 wc -c。超限时按此优先级压缩直到达标:删代码摘录(只写文件名+契约,不写代码)、把 conventions 收成指针、收紧 objective、砍掉“why”叙述、把 done criteria 并入 verify gates。重新计数。上限是硬性的——绝不输出超过 4000。完成标准:wc -c 报告 ≤ 4000,且提示词仍包含 objective + scope + verify gates + done criteria + STOP conditions。
- 输出并汇报:在单个代码块中打印提示词,可直接粘贴到 /goal Implement <slug> 或 /goal Run 之后。说明字符数。指出为达标压缩或删掉了什么,以便操作者若想提高上限可要求加回。
- 避免常见错误:超过 4000 字符;臆造验证命令而非读取仓库真实命令;重述 jackin❯ 自动加载的规则(AGENTS.md、COMMITS.md、ENGINEERING.md)——执行器会自动加载,只指向不复制;内联代码摘录——执行器会读文件,只写文件名及其必须满足的契约;产出依赖聊天上下文的提示词(“as discussed”“the approach we chose”)——不自包含,在全新执行器上会失败;忽略给出的 --plan 文件——它们承载 scope 和 done criteria,合并进来才是重点;丢掉 STOP conditions——它们是执行器唯一诚实的逃生口。
适用边界 · 注意事项
- 撰写研究档案简报(多页 prompt.mdx,经 /goal Follow 运行)→ 用 jackin-research。
- 设计路线图条目本身 → 用 jackin-brainstorm。
- 开 PR → 用 jackin-create-pr / jackin-propose。