Skip to content

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

Latest
Latest

Choose a tag to compare

View all tags
@warm-flame-core warm-flame-core released this 29 Sep 17:23
v1.3.0
56809c8

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 的规则/模板/产出物平台无关；平台适配只提供"在该平台怎么落地"的指引。

Assets 2
Loading