memory-bank-skill 5.0.0

package/skill/memory-bank/references/schema.md

@@ -0,0 +1,112 @@
+# Memory Bank 结构化输出 Schema
+
+> 此文件定义 Memory Bank 操作的结构化输出格式，用于决策审计和工具集成。
+
+---
+
+## 文件选择输出
+
+当 AI 决定加载哪些文件时，输出此格式：
+
+```json
+{
+  "schemaVersion": "1.0",
+  "action": "select_files",
+  "files": [
+    "requirements/REQ-003-payment.md",
+    "learnings/bugs/2024-01-20-payment-timeout.md"
+  ],
+  "reason": "用户讨论支付超时，加载相关需求和历史 bug 经验",
+  "budget": {
+    "filesSelected": 2,
+    "filesLimit": 5,
+    "linesSelected": 270,
+    "linesLimit": 500
+  },
+  "riskAlerts": [
+    {
+      "level": "warning",
+      "file": "learnings/bugs/2024-01-20-payment-timeout.md",
+      "message": "历史上支付模块有超时问题，建议查看"
+    }
+  ]
+}
+```
+
+### 字段说明
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `schemaVersion` | string | Schema 版本号 |
+| `action` | string | 操作类型，固定为 `select_files` |
+| `files` | string[] | 选中的文件路径列表（相对于 memory-bank/） |
+| `reason` | string | 选择这些文件的原因 |
+| `budget.filesSelected` | number | 已选文件数 |
+| `budget.filesLimit` | number | 文件数上限（5） |
+| `budget.linesSelected` | number | 已选文件总行数 |
+| `budget.linesLimit` | number | 行数上限（500） |
+| `riskAlerts` | object[] | 风险提示列表 |
+| `riskAlerts[].level` | string | 风险级别：info / warning / error |
+| `riskAlerts[].file` | string | 相关文件 |
+| `riskAlerts[].message` | string | 提示消息 |
+
+---
+
+## 写入计划输出
+
+当 AI 计划写入 Memory Bank 时，输出此格式：
+
+```json
+{
+  "schemaVersion": "1.0",
+  "action": "memory_ops",
+  "operations": [
+    {
+      "type": "create",
+      "path": "requirements/REQ-004-refund.md",
+      "reason": "用户确认新增退款功能需求"
+    },
+    {
+      "type": "update",
+      "path": "active.md",
+      "block": "MACHINE_BLOCK",
+      "changes": "更新当前焦点为退款功能"
+    },
+    {
+      "type": "update",
+      "path": "_index.md",
+      "changes": "添加 REQ-004 索引条目"
+    }
+  ],
+  "requiresConfirmation": true
+}
+```
+
+### 字段说明
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `schemaVersion` | string | Schema 版本号 |
+| `action` | string | 操作类型，固定为 `memory_ops` |
+| `operations` | object[] | 操作列表 |
+| `operations[].type` | string | 操作类型：create / update / delete |
+| `operations[].path` | string | 目标文件路径（相对于 memory-bank/） |
+| `operations[].block` | string | 更新哪个区块：MACHINE_BLOCK / USER_BLOCK（仅 update） |
+| `operations[].changes` | string | 变更描述 |
+| `operations[].reason` | string | 操作原因（仅 create） |
+| `requiresConfirmation` | boolean | 是否需要用户确认（通常为 true） |
+
+---
+
+## 用户确认格式
+
+向用户展示写入计划时，使用此格式：
+
+```
+[Memory Bank 更新计划]
+- 创建: requirements/REQ-004-refund.md（退款功能需求）
+- 更新: active.md（更新当前焦点）
+- 更新: _index.md（添加新文件索引）
+
+是否执行？[Y/n]
+```

package/skill/memory-bank/references/templates.md

@@ -0,0 +1,225 @@
+# Memory Bank 文件模板
+
+> 此文件包含 Memory Bank 各文件的标准模板。创建新文件时参考此模板。
+
+---
+
+## _index.md（根索引）
+
+```markdown
+# Memory Bank Index
+
+> 自动维护，可手工编辑 summary 以提升检索精度
+
+| path | title | summary | updated | size |
+|------|-------|---------|---------|------|
+```
+
+---
+
+## brief.md
+
+```markdown
+# Project Brief
+
+<!-- MACHINE_BLOCK_START -->
+## 一句话描述
+{项目是什么}
+
+## 核心目标
+- {目标 1}
+- {目标 2}
+
+## 边界
+- 包含: {范围内}
+- 不包含: {范围外}
+
+## 关键约束
+- {约束 1}
+<!-- MACHINE_BLOCK_END -->
+
+<!-- USER_BLOCK_START -->
+## 补充说明
+{用户自由编辑区}
+<!-- USER_BLOCK_END -->
+```
+
+---
+
+## tech.md
+
+```markdown
+# Tech Stack
+
+<!-- MACHINE_BLOCK_START -->
+## 技术栈
+| 层级 | 技术 |
+|------|------|
+| 语言 | {xxx} |
+| 框架 | {xxx} |
+| 数据库 | {xxx} |
+| 部署 | {xxx} |
+
+## 常用命令
+    # 开发
+    {dev command}
+
+    # 测试
+    {test command}
+
+    # 构建
+    {build command}
+
+## 环境要求
+- {requirement 1}
+<!-- MACHINE_BLOCK_END -->
+
+<!-- USER_BLOCK_START -->
+## 补充说明
+{用户自由编辑区}
+<!-- USER_BLOCK_END -->
+```
+
+---
+
+## active.md
+
+```markdown
+# Active Context
+
+<!-- MACHINE_BLOCK_START -->
+> 更新于: {YYYY-MM-DD HH:mm}
+
+## 当前焦点
+{正在做什么}
+
+## 下一步
+1. {next 1}
+2. {next 2}
+
+## 阻塞项
+- {blocker，无则写「无」}
+
+## 最近变更
+| 日期 | 变更 |
+|------|------|
+<!-- MACHINE_BLOCK_END -->
+
+<!-- USER_BLOCK_START -->
+## 用户笔记
+{用户自由编辑区}
+<!-- USER_BLOCK_END -->
+```
+
+---
+
+## progress.md
+
+```markdown
+# Progress
+
+<!-- MACHINE_BLOCK_START -->
+## 已完成
+- [x] {feature 1}
+
+## 进行中
+- [ ] {feature 2} - {进度%}
+
+## 待开发
+- [ ] {feature 3}
+
+## 已知问题
+| ID | 问题 | 优先级 |
+|----|------|--------|
+<!-- MACHINE_BLOCK_END -->
+
+<!-- USER_BLOCK_START -->
+## 备注
+{用户自由编辑区}
+<!-- USER_BLOCK_END -->
+```
+
+---
+
+## patterns.md
+
+```markdown
+# Patterns & Decisions
+
+<!-- MACHINE_BLOCK_START -->
+## 技术决策
+| 日期 | 决策 | 原因 |
+|------|------|------|
+
+## 代码约定
+- {convention 1}
+<!-- MACHINE_BLOCK_END -->
+
+<!-- USER_BLOCK_START -->
+## 补充约定
+{用户自由编辑区}
+<!-- USER_BLOCK_END -->
+```
+
+---
+
+## requirements/REQ-{ID}-{slug}.md
+
+```markdown
+# REQ-{ID}: {标题}
+
+<!-- MACHINE_BLOCK_START -->
+## Status
+{Proposed | Accepted | Implementing | Done | Deprecated}
+
+## Summary
+{一段话描述需求}
+
+## Acceptance Criteria
+- [ ] {criterion 1}
+- [ ] {criterion 2}
+
+## History
+| 日期 | 变更 | 原因 |
+|------|------|------|
+| {date} | 创建需求 | - |
+<!-- MACHINE_BLOCK_END -->
+
+<!-- USER_BLOCK_START -->
+## Notes
+{用户补充说明}
+<!-- USER_BLOCK_END -->
+```
+
+---
+
+## learnings/{type}/{date}-{slug}.md
+
+```markdown
+# {标题}
+
+<!-- MACHINE_BLOCK_START -->
+> 日期: {YYYY-MM-DD}
+> 类型: {bug | performance | integration}
+
+## 问题
+{问题描述}
+
+## 症状
+{如何发现的}
+
+## 根因
+{根本原因}
+
+## 解决方案
+{怎么解决的}
+
+## 教训
+{一句话总结}
+<!-- MACHINE_BLOCK_END -->
+
+<!-- USER_BLOCK_START -->
+## 补充
+{用户自由编辑区}
+<!-- USER_BLOCK_END -->
+```

package/templates/active.md

@@ -0,0 +1,20 @@
+# Active Context
+
+> 更新于: {YYYY-MM-DD HH:mm}
+
+## 当前焦点
+{正在做什么，1-2 句话描述当前最重要的工作}
+
+## 下一步
+1. {下一步 1}
+2. {下一步 2}
+3. {下一步 3}
+
+## 阻塞项
+- {阻塞项描述，无则写「无」}
+
+## 最近变更
+| 日期 | 变更 |
+|------|------|
+| {YYYY-MM-DD} | {变更内容} |
+| {YYYY-MM-DD} | {变更内容} |

package/templates/brief.md

@@ -0,0 +1,17 @@
+# Project Brief
+
+## 一句话描述
+{项目是什么}
+
+## 核心目标
+- {目标 1}
+- {目标 2}
+- {目标 3}
+
+## 边界
+- ✅ 包含: {范围内的功能}
+- ❌ 不包含: {明确不做的事}
+
+## 关键约束
+- {约束 1，如性能要求}
+- {约束 2，如兼容性要求}

package/templates/docs/architecture.md

@@ -0,0 +1,32 @@
+# Architecture
+
+> 更新于: {YYYY-MM-DD}
+
+## 系统概览
+```
+┌─────────────┐     ┌─────────────┐     ┌─────────────┐
+│   Layer 1   │────▶│   Layer 2   │────▶│   Layer 3   │
+│    {名称}   │     │    {名称}   │     │    {名称}   │
+└─────────────┘     └─────────────┘     └─────────────┘
+```
+
+## 模块划分
+| 模块 | 职责 | 文档 |
+|------|------|------|
+| {module1} | {职责描述} | [modules/{module1}.md](modules/{module1}.md) |
+| {module2} | {职责描述} | [modules/{module2}.md](modules/{module2}.md) |
+
+## 关键流程
+
+### {流程 1 名称}
+```
+{步骤 1} → {步骤 2} → {步骤 3} → {步骤 4}
+```
+
+### {流程 2 名称}
+{流程描述}
+
+## 变更记录
+| 日期 | 变更 | 原因 | 影响 |
+|------|------|------|------|
+| {YYYY-MM-DD} | {变更内容} | {为什么改} | {影响范围} |

package/templates/docs/modules/module-template.md

@@ -0,0 +1,34 @@
+# {Module} 模块
+
+> 更新于: {YYYY-MM-DD}
+
+## 职责
+{模块负责什么，1-2 句话}
+
+## 目录结构
+```
+src/{path}/
+├── components/      # {说明}
+├── hooks/           # {说明}
+├── services/        # {说明}
+└── types.ts         # {说明}
+```
+
+## 核心流程
+```
+{输入} → {处理1} → {处理2} → {输出}
+```
+
+## 对外接口
+| 接口 | 说明 | 详见 |
+|------|------|------|
+| {接口名} | {说明} | [specs/{spec}.md](../specs/{spec}.md) |
+
+## 依赖关系
+- **依赖**: {本模块依赖的其他模块}
+- **被依赖**: {依赖本模块的其他模块}
+
+## 变更记录
+| 日期 | 变更 | 原因 |
+|------|------|------|
+| {YYYY-MM-DD} | {变更内容} | {为什么改} |

package/templates/docs/specs/spec-template.md

@@ -0,0 +1,47 @@
+# {Spec Name}
+
+> 更新于: {YYYY-MM-DD}
+
+## 接口定义
+
+### {接口 1}
+```typescript
+// 输入
+interface {Name}Input {
+  field1: string
+  field2: number
+}
+
+// 输出
+interface {Name}Output {
+  success: boolean
+  data: {Type}
+}
+```
+
+## 数据模型
+```typescript
+interface {Model} {
+  id: string
+  field1: string
+  field2: number
+  createdAt: Date
+  updatedAt: Date
+}
+```
+
+## 业务规则
+- {规则 1}
+- {规则 2}
+- {规则 3}
+
+## 边界情况
+| 情况 | 处理方式 |
+|------|----------|
+| {情况 1} | {处理} |
+| {情况 2} | {处理} |
+
+## 变更记录
+| 日期 | 版本 | 变更 | 原因 |
+|------|------|------|------|
+| {YYYY-MM-DD} | v1 | 初始版本 | - |

package/templates/learnings/bugs/YYYY-MM-DD-template.md

@@ -0,0 +1,27 @@
+# {Bug 标题}
+
+> 日期: {YYYY-MM-DD}
+> 类型: bug
+
+## 问题
+{问题描述，什么功能出了什么问题}
+
+## 症状
+{如何发现的，用户看到什么，错误信息是什么}
+
+## 根因
+{根本原因分析}
+
+## 解决方案
+{怎么解决的}
+
+```{lang}
+// 关键修复代码（如有）
+```
+
+## 教训
+{一句话总结，下次如何避免}
+
+## 相关
+- 需求: {REQ-xxx，如有}
+- PR: {链接，如有}

package/templates/learnings/integrations/YYYY-MM-DD-template.md

@@ -0,0 +1,28 @@
+# {集成名称} 集成经验
+
+> 日期: {YYYY-MM-DD}
+> 类型: integration
+> 服务/库: {第三方服务或库名称}
+
+## 背景
+{为什么需要集成这个服务/库}
+
+## 踩坑记录
+
+### 坑 1: {问题}
+- **现象**: {表现}
+- **原因**: {为什么}
+- **解决**: {怎么解决}
+
+### 坑 2: {问题}
+- **现象**: {表现}
+- **原因**: {为什么}
+- **解决**: {怎么解决}
+
+## 最佳实践
+- {实践 1}
+- {实践 2}
+
+## 参考链接
+- 官方文档: {链接}
+- 相关 issue: {链接}

package/templates/learnings/performance/YYYY-MM-DD-template.md

@@ -0,0 +1,25 @@
+# {优化标题}
+
+> 日期: {YYYY-MM-DD}
+> 类型: performance
+
+## 问题
+{性能问题描述，慢在哪里，慢到什么程度}
+
+## 分析
+{如何定位的，瓶颈在哪里}
+
+## 优化方案
+{怎么优化的}
+
+```{lang}
+// 关键优化代码（如有）
+```
+
+## 效果
+| 指标 | 优化前 | 优化后 | 提升 |
+|------|--------|--------|------|
+| {指标} | {值} | {值} | {百分比} |
+
+## 教训
+{一句话总结}

package/templates/patterns.md

@@ -0,0 +1,11 @@
+# Patterns & Decisions
+
+## 技术决策
+| 日期 | 决策 | 原因 |
+|------|------|------|
+| {YYYY-MM-DD} | {决策内容} | {为什么这样选} |
+
+## 代码约定
+- {约定 1}
+- {约定 2}
+- {约定 3}

package/templates/progress.md

@@ -0,0 +1,18 @@
+# Progress
+
+## 已完成 ✅
+- [x] {功能 1}
+- [x] {功能 2}
+
+## 进行中 🔄
+- [ ] {功能 3} - {进度%}
+- [ ] {功能 4} - {进度%}
+
+## 待开发 📋
+- [ ] {功能 5}
+- [ ] {功能 6}
+
+## 已知问题 🐛
+| ID | 问题 | 优先级 | 状态 |
+|----|------|--------|------|
+| #1 | {问题描述} | P0/P1/P2 | open/fixed |

package/templates/requirements/REQ-000-template.md

@@ -0,0 +1,20 @@
+# REQ-{ID}: {标题}
+
+## Status
+{Proposed | Accepted | Implementing | Done | Deprecated}
+
+## Summary
+{一段话描述这个需求要解决什么问题，达成什么目标}
+
+## Acceptance Criteria
+- [ ] {验收标准 1}
+- [ ] {验收标准 2}
+- [ ] {验收标准 3}
+
+## Notes
+{补充说明、技术方案要点、注意事项}
+
+## History
+| 日期 | 变更 | 原因 |
+|------|------|------|
+| {YYYY-MM-DD} | 创建需求 | - |

package/templates/tech.md

@@ -0,0 +1,33 @@
+# Tech Stack
+
+## 技术栈
+| 层级 | 技术 |
+|------|------|
+| 前端 | {框架/库} |
+| 后端 | {框架/语言} |
+| 数据库 | {数据库} |
+| 部署 | {平台} |
+
+## 常用命令
+```bash
+# 开发
+{dev command}
+
+# 测试
+{test command}
+
+# 构建
+{build command}
+
+# 部署
+{deploy command}
+```
+
+## 环境要求
+- Node: {version}
+- 包管理器: {pnpm | npm | yarn}
+- 其他: {其他依赖}
+
+## 已知限制
+- {限制 1}
+- {限制 2}