memory-bank-skill 5.0.0 → 5.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-bank-skill",
-  "version": "5.0.0",
+  "version": "5.1.0",
   "description": "Memory Bank - 项目记忆系统，让 AI 助手在每次对话中都能快速理解项目上下文",
   "type": "module",
   "bin": {

package/plugin/memory-bank.ts

@@ -228,13 +228,20 @@ async function buildMemoryBankContextWithMeta(projectRoot: string): Promise<Memo
     `Read more files from \`memory-bank/\` as needed based on the task.\n\n` +
     `**AI 行为指令**：\n` +
     `- 每次回复末尾加一行确认：\`| 📚 Memory Bank | ${fileList} (${totalChars.toLocaleString()} chars) |\`\n` +
+`- **文档驱动开发（核心原则）**：\n` +
+    `  - 方案讨论完成后，**先写设计文档到 memory-bank/docs/，再写代码**\n` +
+    `  - 设计文档是契约，代码实现要符合文档\n` +
+    `  - 实现完成后回顾：如有偏差，决定是改文档还是改实现\n` +
 `- **写入触发场景**（语义判断，非关键词匹配）：\n` +
+    `  - 方案讨论确定（\"那就这样吧\"、\"OK就这么做\"、\"方案确定\"）→ **先写** memory-bank/docs/design-xxx.md\n` +
     `  - 用户描述新功能/需求（\"我需要...\"、\"能不能加...\"、\"帮我做...\"、\"要实现...\"）→ requirements/\n` +
     `  - 用户做出技术选型（\"我们用 X 吧\"、\"决定采用...\"、\"选择...\"）→ patterns.md\n` +
     `  - 修复了 bug 或踩坑经验（\"原来问题是...\"、\"这个坑是...\"、\"发现...\"）→ learnings/\n` +
     `  - AI 修改了代码/配置文件 → active.md（如涉及 bug 修复则同时 learnings/）\n` +
     `  - 当前任务完成，焦点切换 → active.md\n` +
-    `- **Todo 创建规则（必须）**：创建 todo 时，最后一项必须是"更新 Memory Bank"（检查触发场景并更新相应文件）\n\n` +
+`- **Todo 创建规则（必须）**：\n` +
+    `  - 方案讨论完成后开始落地：第一项必须是\"写入设计文档到 memory-bank/docs/\"\n` +
+    `  - 最后一项必须是\"更新 Memory Bank\"（检查触发场景并更新相应文件）\n\n` +
     `---\n\n`
 
   const wrapped =

package/skill/memory-bank/SKILL.md

@@ -271,13 +271,19 @@ Files updated:
    └─ 按预算限制加载
 
 5. 处理用户请求
+   └─ **文档驱动开发原则**：
+      - 方案讨论确定后 → 先写 memory-bank/docs/design-xxx.md，再写代码
+      - 设计文档是契约，代码要符合文档
+      - 实现完成后回顾：如有偏差，决定改文档还是改实现
    └─ 创建 todo 时：
+      - 方案讨论完成后开始落地 → 第一项是"写入设计文档到 memory-bank/docs/"
       - 已有 memory-bank/ → 最后一项必须是"更新 Memory Bank"
       - 没有 memory-bank/ → 第一项是"初始化 Memory Bank"，最后一项是"更新 Memory Bank"
    └─ 正常工作
 
 6. 执行"更新 Memory Bank" todo 时
    └─ 检查触发场景：
+      - 方案讨论确定 → 创建 memory-bank/docs/design-xxx.md
       - 修改了代码/配置文件 → 更新 active.md
       - 修复了 bug / 踩坑经验 → 创建 learnings/xxx.md
       - 做了技术决策 → 追加 patterns.md