wishos-plan-book
Manifest validDocument-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 r
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)。
Versions
| Latest version | Published | Size |
|---|---|---|
| 0.2.0 | — | — |
Comments
Loading…
Similar plugins
by JohnXu22786
Document workshop skill pack: four pure-prompt Agent Skills that turn a codebase into READMEs, PR descriptions, changelogs and code reviews, installed into dsh via a dsh.bundle plugin row.
★ 0
MIT
Python
Sep 27, 2026
dsh plugin --profile web add dsh-docgenby bauerelizabeth07139
DeepSeek Harness plugin that bundles the simple-plan skill: plan, execute with worker subagents, verify every deliverable with memoryless verifier subagents, and fix in at most three cycles. The Skill is shipped by the bundle, so there is nothing to copy into a skills directory.
★ 0
MIT
JavaScript
Oct 8, 2026
dsh plugin --profile web add dsh-simple-planby hasan-aghayev
Automatically orchestrates complex DeepSeek Harness requests. It detects when delegation is useful, builds a dependency-aware plan, assigns bounded researcher, architect, backend, frontend, tester, an
★ 0
MIT
TypeScript
Oct 22, 2026
dsh plugin --profile web add dsh-task-orchestratorDelivery workflow preset for DeepSeek Harness: an agent protocol plus seven tools that keep user requests verbatim, record feedback decisions, plan tasks with acceptance criteria, log real verificatio
★ 0
dsh plugin --profile web add dsh-plugin-dev-workflowby KratosLee-6
DeepSeek Harness Plugins · A local-first DeepSeek Harness plugin for discovering, combining, and turning skills into actionable ideas.
★ 1
MIT
TypeScript
Nov 8, 2026
dsh plugin --profile web add dsh-plugin-sparkby CHAAAAA
DeepSeek Harness(DSH)的项目与工程管理插件,把需求、项目文档、Git 提交、AI 提交信息、代码评审、工作树、后台任务与周报聚合到一个侧边栏工作台里。
★ 0
MIT
TypeScript
Nov 2, 2026
dsh plugin --profile web add dsh-devbench-plugin