memory-bank-skill 5.0.0 → 5.2.0

package/README.md

@@ -175,5 +175,5 @@ service=memory-bank Plugin initialized (unified) {"projectRoot":"..."}
 
 ## 版本
 
-- **版本**: 5.0.0
-- **主要更新**: 切换到 OpenCode 原生 skill 路径（`~/.config/opencode/skill/`），移除 Claude 兼容层
+- **版本**: 5.2.0
+- **主要更新**: 增加 Design 设计文档支持，方案讨论确定时自动创建/更新 docs/design-*.md

package/dist/cli.js

@@ -24,7 +24,7 @@ import { homedir } from "os";
 import { join, dirname } from "path";
 import { createHash } from "crypto";
 import { fileURLToPath } from "url";
-var VERSION = "5.0.0";
+var VERSION = "5.2.0";
 var colors = {
   reset: "\x1B[0m",
   bold: "\x1B[1m",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-bank-skill",
-  "version": "5.0.0",
+  "version": "5.2.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` +
+    `  - 方案讨论确定 / 设计变更（\"重新设计\"、\"改一下设计\"、\"那就这样吧\"）→ 检查 docs/design-*.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

@@ -120,6 +120,7 @@ memory-bank/
 | 事件类型 | 触发条件 | 创建/更新 |
 |---------|---------|----------|
 | **New Entity** | 确定新需求/模块/API | requirements/REQ-xxx.md 或 docs/modules/xxx.md |
+| **Design** | 新设计 / 重新设计 / 设计变更 | docs/design-{slug}.md（已存在则更新） |
 | **Decision** | 技术选型确定，用户认可 | patterns.md |
 | **Learning** | Bug 修复/性能优化/集成踩坑 | learnings/{type}/{date}-{slug}.md |
 
@@ -271,13 +272,21 @@ 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 时
    └─ 检查触发场景：
+      - 方案讨论确定 / 设计变更 → 检查 docs/design-*.md 是否已存在
+        - 存在 → 更新该文档
+        - 不存在 → 创建新文档
       - 修改了代码/配置文件 → 更新 active.md
       - 修复了 bug / 踩坑经验 → 创建 learnings/xxx.md
       - 做了技术决策 → 追加 patterns.md