dsh-plugin-task-forge
dsh 插件：将粗略需求整理成带版本的开源风格任务书，将其转发到任意 AI 窗口，并通过回读握手确保交接无损；/forge /relay /ack /answer /forge-list。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:121212165/dsh-plugin-task-forge#3dfe2ad10987ba078759b15878352e4c58104a17Plugin Task Forge 以 dsh-plugin-task-forge 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
EN · Compiles a rough need into a versioned task book, then hands it to any other AI window through a read-back handshake: /forge compiles, /relay emits, /ack proves the receiver got it byte-for-byte, /answer returns — aimed at the lossy copy-paste handoff between agents. · 61 node --test green · design notes in TASK-FORGE-DESIGN.md.
dsh 插件：先把大白话编译成任务书，再无损交接给任意窗口的 AI。
普通人和 AI 协作的真实瓶颈不是"不会写提示词"，而是缺一道编译工序：你脑子里只有一个模糊需求，直接丢给干活的 AI，它理解歪了你也不知道；换了窗口、换了 IDE，上下文全靠人肉搬运。task-forge 把这件事产品化：
/forge 把你的大白话编译成一份开源项目标准的任务书（目标/背景/约束/验收标准/已定决策/开放缺口，全部编号）；/relay 导出自包含的交接包（单文件 markdown），粘贴给任何窗口的任何 AI；STATUS: READY）才被允许开工——LLM 之间传东西永远有损耗，这套协议把损耗逼到明面上、几轮内逼到零；/answer 补缺口自动版本 +1；/forge-list 台账总览"哪个窗口手里是哪个版本"；进行中任务注入每个新会话的系统提示。三步，实测于 @deepseek-ai/dsh@0.1.7-alpha.1（需 pnpm 在 PATH 上）：
# ① 装进 profile：dsh plugin 把参数原样转发给 pnpm，git 包会自动跑 prepare 构建 lib/
dsh plugin --profile web add github:121212165/dsh-plugin-task-forge
② 把本仓库根目录 cordis.patch.yml 的内容并进 $DSH_HOME/profiles/web/cordis.patch.yml。
该文件默认是 []，所以要么整份替换，要么把 insert 条目并进同一个数组；不要直接追加——
追加会形成两个 YAML 文档，启动即报
failed to parse overlay ... end of the stream or a document separator is expected（本机实测踩过）。
③ 重启 dsh。配置层与 client 半都要重启才生效（客户端按 boot 时算出的内容 rev 下发，硬刷新浏览器没用）。
自检挂载：dsh --profile web --dump-config | grep dsh-plugin-task-forge，应看到该条目。
| 命令 | 作用 |
|---|---|
/forge <需求> [--mode interview] | 编译。默认 auto：模型自己推演、暴露假设，定不了的写成编号缺口 Q1/Q2…；--mode interview 先出问题清单等你答完再编译。编译结果经 forge_write 工具落盘 |
/relay <id> [--to <窗口名>|ide:<工具名>] | 导出交接包到 ~/.dsh/task-forge/outbox/<id>-v<n>.md，全文粘贴给对方窗口；--to ide:zcode 这类还会在当前项目 <hubPath>/tasks/ 落一份同字节副本，并打印该 IDE 的接手步骤 |
/ack <id> [--to <窗口名>] <回读全文> | 登记对方回读：READY 放行并给该窗口盖上「确认了哪一版」；NEED-INPUT 的缺口自动登记进任务书。有多个窗口时必须带 --to，否则不知道该记在谁头上 |
/answer <id> <Q编号> <答案> | 缺口答案写入已定决策（D 编号），版本 +1，提醒你重新 relay 新版；interview 任务答完最后一个 Q 会自动重新注入编译指令，不用你二次触发 |
/forge-list | 台账：任务 × 版本 × 每个窗口的回读状态（窗口A✓v2 / 窗口B◐v1 / 窗口C○）× 缺口/决策计数 × 下一步 |
/forge-done <id> | 标记完成（不再注入系统提示） |
每份任务书尾部固定携带握手指令，要求接收方在开工前输出：
version: <它读到的版本号>
【回读】用自己的话复述目标、约束、验收标准（逐条对应编号）
【缺口】发现的信息不足或矛盾，逐条编号；没有写"无"
STATUS: READY 或 STATUS: NEED-INPUT
/ack 直接判无效并给出补救话术；/answer 后版本 +1，所有交接引用必须带 id@version——版本号是跨窗口唯一权威。~/.dsh/task-forge/
├── tasks/<id>/task.md # 任务书本体（frontmatter + 六段正文 + 握手指令）
├── outbox/<id>-v<n>.md # 交接包导出
└── ledger.jsonl # 握手台账（每次 created/revised/relayed/acked/… 一行）
进行中任务（非 done）按 limit/maxChars 预算注入每个会话的系统提示（## 进行中任务（task-forge）），新窗口一开就知道有哪些任务在飞。
| 字段 | 默认 | 作用 |
|---|---|---|
enabled | true | 关掉后 apply 直接返回，不注册任何命令/工具/注入 |
dataPath | ~/.dsh/task-forge | 任务书本体、交接包与台账的根目录；支持 ~ 前缀 |
hubPath | .hub | --to ide:<工具名> 那份项目内副本的目录，相对当前工作目录解析（写绝对路径也可以） |
quotaSummaryPath | ~/.dsh/quota/summary.json | quota 发布的预算契约文件；读不到就当没装 quota，不警告也不报错。支持 ~ 前缀 |
limit / maxChars | 8 / 900 | 注入段的条数与字符预算；超限的行截断而不是丢弃最新任务 |
order | 690 | 注入段在系统提示里的排序位置 |
limit、maxChars、order、hubPath 都走启动自检：填错启动即失败并点名 task-forge，不会带着一个不可用的台账静默运行。
| 来源 | 借鉴 | 改编 | 原创 |
|---|---|---|---|
| dsh-plugin-pinboard（自家） | systemPrompt.section 注入机制、limit/maxChars 预算模型 | 注入内容从静态便签换成读台账现算的任务状态 | —— |
| dsh-plugin-ide-hub（自家） | "一份本体多 IDE 生效"的指针思想 | 本体从规则文件换成任务书；交接走自包含单文件，不依赖任何 IDE 读取器 | —— |
| dsh-plugin-prompt-vault（自家） | ctx.agents.followup() 注入通道、v4 producer-owned source kind | vault 降级为非依赖；编译指令按 auto/interview 双模式生成 | —— |
| kaanozhan/Frame（394★） | spec 四件套、编号化决策 | 四件套收敛为单文件任务书，加版本号与握手 | 回读握手协议 |
| distilly（25k★） | "思维→结构化产物"的大方向 | 它蒸馏成 Skill，我们编译成任务书+握手，面向跨工具交接 | 无损传递的判定机制 |
| dsh-auto-review（222★，PerryLink） | 装配层测试方法论：mock ctx harness + 把命令 handler 当真函数调，补上"纯函数层测试好、装配层零覆盖"的断层（其五层模型的第 1-3 层） | 它用 vitest fork pool，我们按家族标准用 node:test + 真临时目录；其第 4-5 层（真实 Loader 子进程组装）暂未引入 | —— |
npm run check # typecheck + node --test + tsc build
61 个测试，两层：
phase）落盘与清除、答复被编译器丢掉时自动补回、握手解析（中文冒号/旧版本/结构残缺/空缺口/自作主张的 READY 降级）、台账解析/折叠/注入预算、IDE 派发表；test/harness.ts + test/plugin.test.ts）：真实 apply() 挂到脚本化 mock ctx 上（命令/工具/注入/followup 全部捕获），在真临时目录里驱动完整协议流——/forge 落盘并注入编译指令（含 headless 粘贴回退）、forge_write 校验拒绝、interview 出问题清单 → /answer 答完最后一问自动二次注入编译、/relay 导出交接包与 --to ide:* 的项目内同字节副本、/ack 垃圾输入拒绝/READY 放行/降级/旧版本拦截/每窗口盖章、/answer 版本推进与缺口编号不复用、/forge-list 的每窗口状态、forge_write 的 presentCall/presentResult 卡片、坏配置启动点名。全家第一个有装配层覆盖的插件，harness 可直接复制给其他 17 个。v0.2 已落地：interview 多轮闭环（答完最后一问自动重编译）、--to ide:<工具名> 派发（落项目内副本 + 逐 IDE 接手步骤）、每窗口回读台账（✓当前版 / ◐旧版 / ○未回读）、forge_write 的 presentCall/presentResult 卡片。
/hub-init）上线后接上；/relay 会读 quota 的 summary.json（家族契约：budgetTokens/maxSessionRatio/nextTurnEstTokens），预算已用到 80% 以上时在交接输出里追加一行警告；quota 没装、文件坏、或读数是一小时以前的都保持沉默——拿昨天的仪表吓人是更糟的结果；ctx.agents.followup() 的运行时验证仍在观察（headless 无活动会话时走粘贴回退，已在测试里覆盖）。MIT