v1.3.0 — 入口文件常驻/按需分层 + 防遗忘机制 + WorkBuddy 适配

v1.3.0 — 入口规范文件常驻/按需分层 + 防遗忘机制 + DSH 适配复核 + WorkBuddy 适配

对应 skill 版本 v11.4（2026-09-30）

⭐ 本版最大变化：入口规范文件「常驻 vs 按需」分层

生成的 AGENTS.md / CLAUDE.md 以前把「无论做什么都要遵守的」和「细则」混在一起。本版确立：

入口文件 = 常驻区，只放两样东西 ——

1. 无论做什么都必须遵守的（硬门禁、纪律红线、指令优先级）
2. 无论做什么都必须知道去哪找的（「规范索引」路由表 + 「动作 → 必须更新」表）

其余一切按需加载。

为什么：入口文件由平台每次会话自动注入，每一轮都在上下文里；而各平台对它有硬上限 —— DSH maxBytes: 65536（源码实测）、Codex 32 KiB、Claude Code 40k 字符、Gemini ≈12k。本版新增体量门禁：生成的入口文件 ≤ 8 KB（实测模板骨架 ≈7.59 KB）。

🆕 新增「防 AI 忘记写文档」机制

针对真实痛点：项目新增了工具/命令/依赖/接口后，AI 常常忘记写对应的文档。

• 新增「动作 → 必须更新」表（以事件为键）：新增/删除工具·脚本·命令、新增依赖、改环境要求、增改接口·路由·权限点、增改表·字段、增删目录、踩到新坑、引入新规范 —— 每类都写明必须同时更新哪个文档
• 记忆库「回答末尾自检」三步 → 四步：新增第③步 动作回看（逐条对照上表，对应文档没更新不许结束）
• 模块收尾回看新增「文档影响清点」（模块级）
• 新增「遗漏型借口自查表」：专治「只是个小脚本」「以后补」「下个模块一起写」「有注释就够了」这类无自觉的遗漏（与原有「明知故犯」型借口表互补）

📁 踩坑沉淀升级为两层

依据 DSH 开发者版的做法（docs/postmortem/ + docs/defensive-patterns.md）：

• 新增 docs/已知坑/：索引（三条限定语 + 规则速查表 + 全部坑索引，1–3 KB）＋ 单篇（现象 / 排查过程 / 根因 / 固定解法 / 如何验证已规避 / 提炼规则）
• 准入三判据：隐蔽 + 系统性 + 重犯代价高（只满足"一次性笔误"的进模块 changelog）
• 新建单篇必须同时补 README 两张表（缺索引 ＝ 未写完）
• 原散在三处的踩坑落点（入口文件环境速查表 / 部署文档「已知坑」节 / tools README「使用注意」）收敛为引用不复制

🧩 模板体系：34 个

新增	说明
模板 32 · AI 协作规范	从模板 01 C 区外移：记忆库纪律 / 动作标签表 / 借口表 / 签署责任矩阵（唯一出处）/ 防遗忘机制
模板 33 · 编码规范	从模板 01 B 区外移：通用 8 项 + 按需 5 项（各带 on/off）；提交格式与中文排版改为引用既有模板 28 / 27
模板 34 · 已知坑文件夹	见上「踩坑沉淀升级」
模板 01	重写 398 → 287 行：A6+A7 合并、信息闭环图 5 条→3 条主闭环、产出红线 7 条→8 条（含体量门禁）

🔧 DSH 适配复核（对照 DSH 0.2.0-rc.2 源码）

• 🔴 修正事实错误：platforms/dsh/adaptation.md 2b 表原写 workflow 继承父会话上下文 —— 实际默认 provider: spawn 且 startChild 不传 seed，不继承；已改，并把「脚本里注明先读 references」升级为硬要求
• customSkillDirs 段落重写：补「patch 整段替换 config、非深合并」警示；~/.agents/skills 更正为**官方约定根（rank 500）**而非"新推荐"；补「两个 junction 同时挂载会被发现两次」警示
• 补 --profile <名字> 语义警示（装给谁用 + npm 版 CLI 拒绝 electron/desktop profile）
• lib/index.js 加固：支持块标量（| / >）与官方 invocation 键 disable-model-invocation / user-invocable；并修复 CRLF 行尾下 frontmatter 解析为空的缺陷

🧩 新增 WorkBuddy 平台适配（待会话级实测）

• 认 AGENTS.md（不认 CLAUDE.md）；技能根 ~/.workbuddy/skills/（用户级）与 <项目>/.workbuddy/skills/
• 能力映射：Agent 子代理 / Workflow / AskUserQuestion / PowerShell·Bash / EnterPlanMode·ExitPlanMode
• ⚠️ 本平台适配按「三判据②」属新增平台适配、需实测，文件内逐项标注【实测】/【推断】/【待实测】并附 8 条待实测清单 —— 尚未转正

🛠 工具改进

• publish.ps1：新增第 6 项 npm 包内容断言（npm pack --dry-run 的文件清单不得含 _private/ scripts/ AGENTS.md .github/）
• secret.ps1：增量加密 —— 默认跳过 .enc 不早于明文的文件（salt/nonce 随机导致同样明文每次密文不同，全量重写会让每次提交都显示全部 .enc 变更）；新增 -Force 强制全量

📦 安装

dsh plugin --profile web add new-project-init                     # DSH（npm）
dsh plugin --profile web add github:warm-flame-core/new-project-init   # 或 GitHub

其他平台：Reasonix / ZCode / WorkBuddy / Claude Code / Codex —— 见 README 各平台节。

---

注意：本 skill 的规则/模板/产出物平台无关；平台适配只提供"在该平台怎么落地"的指引。

v1.2.0 — 五件套颗粒度机制 + 流程 gate 一批 + ZCode 适配

五件套颗粒度机制 + 流程 gate 一批 + ZCode 平台适配（对应 skill v11.3）。

本版内容

• 五件套颗粒度四层机制：新增 references/五件套颗粒度标尺.md（颗粒度下限表 / BDD 场景类型覆盖清单 / 脱敏实例节选 / 硬验收词表）；首模块五件套签署后固化为「样板」，后续模块先读样板再写
• 流程 gate 一批（ISSUE-019026、028032）：自测后必须独立审查、多角色 logs 补写、权限白名单三处对齐、根因先最小对比验证、DDL 前实测数据库类型、BDD 覆盖「已有数据→修改→重传」
• ZCode 平台适配：新增 platforms/zcode/adaptation.md + .zcode-plugin/plugin.json；安装根 ~/.agents/skills/（多工具共享）
• 受控环境已知坑下沉各平台 adaptation.md
• .gitignore 改 _private/* 全忽略 + 密文豁免

安装

dsh plugin --profile web add new-project-init

v1.1.0 — DSH 完全适配复核 + 恢复 npm 发布 + 市场上架

DSH 完全适配复核 + 恢复 npm 发布 + 插件市场上架（对应 skill v11.2）。

本版内容

• DSH 适配复核：对照官方源码核对 skill provider 协议与 8 项能力映射（ask_user_question / subagent·subagent_fork·workflow / customSkillDirs / dsh plugin add / rank 语义 / profile 与 DSH_HOME）
• 恢复 npm 发布渠道（此前暂停）
• 上架：awesome-dsh-plugin（PR #1994）、reasonix-plugin.json（reasonix.io/skills）
• 仓库加 dsh-plugin topic

v1.0.1 — Reasonix 深度适配

Reasonix 深度适配（对应 skill v10.9）。

本版内容

• 新增 platforms/reasonix/adaptation.md：能力映射全文（多 agent 角色 → 原生 task/review/wait/explore；子代理 → reasonix subagent；常驻纪律并入项目 AGENTS.md）
• 安装：~/.reasonix/skills/ junction，或 reasonix.toml 的 [skills] paths
• 社区发布：https://reasonix.io/skills/
• README 新增「Reasonix 适配」节 + 跨平台表补行

v1.0.0 — 首次发布：DSH 插件包（npm）

首次以 DSH 插件包 形式发布（npm）。

本版内容（对应 skill v10.8）

• 新增 package.json：声明 dsh.bundle.patch → 插件安装即装载
• 新增 lib/index.js：把包根 SKILL.md 注册进 DSH ctx.skills（rank 550，resourceBase = 包根，templates/ 等相对引用可解析）
• 新增 platforms/dsh/cordis.patch.yml：插入 new-project-init 行
• README 补「其他平台的使用方式」跨平台表

安装

dsh plugin --profile web add new-project-init
dsh plugin --profile web add github:warm-flame-core/new-project-init