wishos-plan-book
ziming-x/wishos-plan-book
Document-form plan task-book plugin for DeepSeek Harness: one entry skill plus three tools — structure check, skeleton generator, package self-check — for a four-element task book, with the protocol reference shipped in-package. Only the generator writes files, and it refuses to overwrite an existing one unless force is set.
Instalar
dsh plugin --profile web add github:ziming-x/wishos-plan-bookREADME
wishos-plan-book · 计划任务书（文档态计划）独立插件
创作者 / Creator：ZiMing-X（GitHub: https://github.com/ZiMing-X）· 许可证 / License：Apache-2.0（见
LICENSE）一句话：把「计划任务书」从 V12 技能束里拆出来单独装 —— 1 个入口技能 + 3 个工具 + 规程全文，即插即用、自带门禁、可一行回滚。
这是 0.2.0 公开版：
references/已做「署名归一 + 内部项目代号脱敏」（md5 见gate.mjsA9 与SPLIT.md），原私有版归档在内部 dist。
30 秒上手（装完之后）
① 自检 plan_book_health() → ok=true（技能已注册 · 7/7 夹具）
② 生成骨架 plan_book_new path=docs/某任务-任务书-v1.0.md title="某任务" batches=5
③ 填实质内容（人/agent 逐批填四要素）
④ 校验 plan_book_check path=docs/某任务-任务书-v1.0.md
→ extractable 且 placeholders=0 = 真过；
extractable_with_placeholders = 结构过但还没填完；
not_extractable = 缺表 / 表里缺键 / 没总门禁
对话里直接说下面这些词，技能会自动触发： 计划任务书 / 任务书 / 文档态计划 / 分批执行计划 / 四要素 / 推进门禁 / 总门禁 / 计划冻结 / 执行记录 / 复盘回流。
| 你想干什么 | 怎么说 / 怎么调 |
|---|---|
| 判断这事该不该写任务书 | 「这任务要不要写任务书？」→ 技能按门槛表判（单步/即问即答 ⇒ 豁免） |
| 写一份新任务书 | 「帮我写个任务书」或 plan_book_new |
| 审一份已有任务书 | 「按四要素校验这份计划」或 plan_book_check |
| 查插件是否正常 | plan_book_health |
| 看四要素怎么写 / 正反样例 | 让技能读 references/four-elements.md（按需，不常驻上下文） |
它是不是独立 / 即插即用
- 零第三方依赖：
plugin.js只 importnode:fs/node:path/node:url（门禁 A10 每次复跑）。 - 只依赖 DSH 核心服务：
inject = ['skills', 'tools']，两者都是宿主自带能力，不需要其它插件。 - 资源全在包内：技能正文读
skills/plan-book/SKILL.md，references/、schema、manifest都按包内路径解析（resourceBase指向包内目录）；不读宿主其它目录、不改预设技能根。 - 一条命令安装：
dsh plugin add "file:<tgz>"—— 同时写dependencies与dsh.profile.bundles，本机实测热加载、无需重启。 - 与其它 wishos 包无关：
wishos-v12-core-skills（不依赖）、wishos-core/wishos-ops（无关）。 - 兼容面：Node
>=22.19.0；dsh>=0.2.1-rc.2 <0.2.2-0 || >=0.2.2-rc.1 <0.3.0-0（engines声明，门禁 A6 校验）。
已知边界（诚实登记）：
| # | 边界 | 处置 |
|---|---|---|
| 1 | install.cmd / install.ps1 仅 Windows | Linux/macOS（如 NAS 容器）直接用 tgz：dsh plugin add "file:/path/x.tgz" |
| 2 | dsh plugin remove 是否自动清 dsh.profile.bundles 那一行未验证 | 卸载后用 uninstall.ps1 报告残留，或人工核对 profile 的 package.json 两处 |
| 3 | 宿主若不支持热加载 | 重启 dsh（会中断当前会话）后再调 plan_book_health |
| 4 | 本包是文档态计划 | 机器态计划（JSON / MetaSkill）走 plan-template → plan-executor，不归本包 |
包布局
wishos-plan-book/
├── package.json # dsh.bundle.patch + exports/files + engines.dsh
├── cordis.patch.yml # 一行 insert（id = wishos-plan-book）
├── plugin.js # 技能注册 + 3 工具 + 结构判据内核（零依赖）
├── skills.manifest.json # 技能清单（name/description/whenToUse）
├── skills/plan-book/
│ ├── SKILL.md # 入口技能：判档 → 六步 → 四要素 → 三条硬规则 → 反模式
│ └── references/
│ ├── doc-plan-protocol.md # 规程全文（字节一致复制 · md5 见 SPLIT.md）
│ └── four-elements.md # 四要素写法 + 正反样例
├── schemas/plan-book.schema.json # 任务书 frontmatter 约束
├── locale/{zh,en}.json · icon.svg
├── tools/dev/gate.mjs # 包内门禁（结构 10 + mock 冒烟 + 夹具 + 能红 + parity）
├── SPLIT.md # 拆解清单：边界 / 逐件 md5 / 退场 / 未验证
├── LICENSE # Apache-2.0
└── README.md
工具
| 工具 | 参数 | 判据（缺一不可） |
|---|---|---|
plan_book_check | path | status=extractable 且 placeholders=0 才算真过；extractable_with_placeholders 表示结构过关但实质未填 |
plan_book_new | path title [plan_id] [batches=3] [date] [execution_log] [scope] [redlines] [force=false] | 生成件自身须过 plan_book_check；已存在文件默认拒绝覆盖 |
plan_book_health | — | ok=true：1 技能已注册 + references 在盘 + 7 项结构夹具全过 |
结构判据与 Python 参考实现 _plan4-check.py 同源不同实现（互为探针）：
表头四键须落在 4 个不同列 · 每行四列非空（— 表示“无”，不等于留空）· 全文须有 total_gate/「总门禁」声明。
安装
方式 A（推荐 · 即插即用）：tgz 一条命令
# 1) 找 dsh CLI（不在 PATH 时用本机 checkout 路径，按实际安装位置改）
$dsh = (Get-Command dsh -ErrorAction SilentlyContinue).Source
if (-not $dsh) { $dsh = "$env:USERPROFILE\dsh-0.2.1\node_modules\.bin\dsh.cmd" }
# 2) 备份 profile 配置（保险）
$pkg = "$env:USERPROFILE\.dsh\profiles\web\package.json"
Copy-Item $pkg "$pkg.bak-$(Get-Date -Format yyyyMMdd-HHmmss)"
# 3) 安装（file: + 正斜杠；包在哪个目录就 Resolve-Path 哪个）
& $dsh plugin --profile web add "file:$((Resolve-Path .\wishos-plan-book-0.2.0.tgz).Path -replace '\\','/')"
Linux / macOS：
dsh plugin --profile web add "file:/path/to/wishos-plan-book-0.2.0.tgz"
实测 2026-11-07：dsh CLI
0.2.1-rc.2· pnpm11.28.7· 8.7 s。dsh plugin add会同时写dependencies与dsh.profile.bundles，宿主热加载后plan-book技能与 3 个工具即可用。
方式 B（开发态）：link 源码目录
& $dsh plugin --profile web add "link:<包源码目录绝对路径>"
node <包源码目录>\tools\dev\gate.mjs --parity "<元项目>\docs"
link: 指向源码，改完即生效；挪走/改名包目录会断链。file:（tgz）是安装副本，不受源码改动影响。
装完就地验证（三步，均已实测通过）
node "$env:USERPROFILE\.dsh\profiles\web\node_modules\wishos-plan-book\tools\dev\verify-install.mjs" "$env:USERPROFILE\.dsh\profiles\web"
# V0–V4 全绿：包可解析 / 入口可 import / 导出形态对 / 版本一致
# 然后在会话里调用：
# plan_book_health → ok=true（3/3 文件 · 已注册 · 7/7 夹具）
# plan_book_check path=<任一任务书.md> → 真任务书应 extractable
# plan_book_new path=<新路径> title=<标题> batches=3 → extractable_with_placeholders + 拒覆盖
宿主侧门槛（包内自证）：dsh.bundle.patch 已声明 · engines.dsh 覆盖 0.2.1-rc.2 · 零第三方依赖 · 包内零盘符绝对路径 · 入口同时声明 main 与 exports["."]。
验证（不需要装宿主）
cd <包源码目录>
node tools/dev/gate.mjs # 结构 + mock 宿主冒烟 + 夹具 + 能红 → 期望退码 0（18 项）
node tools/dev/gate.mjs --parity "<元项目>\docs" # 追加 JS↔Python parity（127 份真实文档：22 PASS / 105 FAIL，mismatch 0）
--parity 需要 Python 在 PATH（参考实现路径写在 gate.mjs 顶部 PY_REF，只读；便携包里可用环境变量 PLAN4_CHECK 指定）。
已知好/坏样本对照也已实测：医保 v1.1（12 行四键）→ extractable；v1.0 → not_extractable（理由「缺表」）。
卸载 / 回滚
& $dsh plugin --profile web remove wishos-plan-book
# 删后人工核对 profile\package.json 两处（dependencies + dsh.profile.bundles）是否都已清掉
# —— remove 是否自动清 bundles 行未验证；然后重启宿主
包目录保留不删即可（未激活＝零副作用）。一键卸载（Windows）：uninstall.ps1 -Profile web，它会报告 bundles 残留。
退场（移走预设里同名的 doc-plan-protocol，避免双副本）见 SPLIT.md §四 —— 装成并通过验证后才做。
与其它包的关系
| 包 | 关系 |
|---|---|
wishos-v12-core-skills | 不依赖。它若装过，本包的 plan-book 与它的 doc-plan-protocol 是两套并存；退场步骤负责收掉重复 |
wishos-core | 无关（persona/工具面 vs 计划文档形态） |
wishos-ops | 无关 |
许可证 / License
Apache-2.0（全文见 LICENSE）：可自由使用、修改、再分发；请保留 LICENSE 与版权声明。
技能正文与规程全文改写自项目内部协议（公开版已做「署名归一 + 内部项目代号脱敏」，不改变条款含义）。
Copyright 2026 ZiMing-X（GitHub: https://github.com/ZiMing-X）。