@chongyan/autospec 1.0.1

package/plugins/commands/memory.md

@@ -0,0 +1,249 @@
+---
+name: memory
+description: "管理项目记忆系统 - 查看状态、搜索记忆、手动添加记忆、导出导入"
+---
+
+# AutoSpec Memory — 记忆管理
+
+管理项目的智能体记忆系统，支持全局 + 项目双模式。
+
+## 用法
+
+```
+/autospec:memory [action] [options]
+```
+
+## Actions
+
+| 命令 | 描述 |
+|------|------|
+| `status` | 查看记忆系统状态（全局+项目） |
+| `show [layer]` | 显示指定层的记忆（core/working/project/sessions） |
+| `search <query>` | 搜索记忆内容 |
+| `add <type> <content>` | 手动添加记忆 |
+| `update-north-star` | 更新北极星指标 |
+| `add-constraint <content>` | 添加硬约束 |
+| `clean` | 清理过期记忆 |
+| `export [--global]` | 导出记忆（可迁移到其他项目/团队） |
+| `import [--global] <file>` | 导入记忆 |
+
+## 记忆层次
+
+| 层次 | 说明 | 作用域 |
+|------|------|--------|
+| **core** | 核心记忆（北极星、偏好、约束） | 全局 + 项目 |
+| **working** | 工作记忆（当前任务上下文） | 项目 |
+| **sessions** | 会话记忆（重要对话总结） | 项目 |
+| **project** | 项目记忆（技术栈、架构决策） | 项目 |
+
+## 示例
+
+### 查看状态
+
+```bash
+/autospec:memory status
+```
+
+输出示例：
+```
+📋 记忆系统状态
+
+全局记忆：✅ 已初始化
+  团队偏好：已配置
+  通用约束：3 条
+
+项目记忆：✅ 已初始化
+  北极星指标：自主完成率 65% → 80%
+  关键结果：2 个
+  活跃决策：3 个
+  会话记录：15 条
+
+最后更新：2025-03-25
+```
+
+### 查看北极星指标
+
+```bash
+/autospec:memory show core
+```
+
+### 搜索记忆
+
+```bash
+# 搜索与"架构"相关的记忆
+/autospec:memory search 架构
+
+# 搜索与"测试"相关的记忆
+/autospec:memory search 测试
+```
+
+### 更新北极星指标
+
+```bash
+/autospec:memory update-north-star
+```
+
+系统会引导你填写：
+- 使命（Mission）
+- 愿景（Vision）
+- 北极星指标名称、目标值、当前值
+- 关键结果
+
+### 添加约束
+
+```bash
+# 添加硬约束（不可违反的红线）
+/autospec:memory add-constraint "禁止使用 localStorage 存储敏感数据"
+
+# 添加到全局约束（影响所有项目）
+/autospec:memory add-constraint "所有 API 必须有审计日志" --global
+```
+
+### 手动添加记忆
+
+```bash
+# 添加技术栈信息
+/autospec:memory add tech-stack "使用 TypeScript + React"
+
+# 添加架构决策
+/autospec:memory add decision "采用微前端架构，使用 qiankun 框架"
+```
+
+### 导出/导入记忆
+
+```bash
+# 导出项目记忆（供其他项目使用）
+/autospec:memory export > project-memory.json
+
+# 导出全局记忆（供团队成员使用）
+/autospec:memory export --global > team-memory.json
+
+# 导入记忆
+/autospec:memory import team-memory.json --global
+```
+
+## 双模式说明
+
+记忆系统支持**全局 + 项目**双模式：
+
+### 全局记忆（~/.autospec-global/autospec:memory/）
+
+- **团队偏好**：沟通风格、技术偏好、工作流偏好
+- **通用约束**：跨项目的红线规则
+- **学习模式**：从多个项目沉淀的最佳实践
+
+适用场景：
+- 新项目自动继承团队偏好
+- 团队成员间共享配置
+- 跨项目经验复用
+
+### 项目记忆（.autospec/autospec:memory/）
+
+- **北极星指标**：项目特有的目标和关键结果
+- **技术栈**：项目使用的技术
+- **架构决策**：项目的 ADR 记录
+- **会话记忆**：项目相关的对话总结
+
+适用场景：
+- 项目特有的目标追踪
+- 项目上下文持久化
+- 随 Git 仓库迁移
+
+### 读取优先级
+
+```
+项目本地记忆 > 全局记忆 > 默认值
+```
+
+项目可以覆盖全局偏好，实现特殊配置。
+
+## 自动记忆提取
+
+系统会在以下时机自动提取记忆：
+
+1. **会话结束时**：从对话中提取关键信息
+2. **阶段完成时**：记录重要决策和产出
+3. **交付完成时**：沉淀最佳实践到全局记忆
+
+提取规则：
+- 目标/指标相关 → 项目北极星
+- 偏好相关 → 全局团队偏好
+- 决策相关 → 项目架构记录
+- 学习模式 → 全局学习模式
+
+## 与 pending-dashboard 集成
+
+新会话启动时，pending-dashboard 会自动扫描记忆状态：
+
+- 北极星指标进度落后 > 10% → 提示关注
+- 核心记忆 > 30 天未更新 → 提示刷新
+- 全局记忆未初始化 → 提示初始化
+
+---
+
+## 执行指令
+
+### Step 1: 解析参数
+
+解析用户输入的 action 和 options：
+
+```
+1. 提取 action（status/show/search/add/update-north-star/add-constraint/clean/export/import）
+2. 提取 options（--global 等）
+3. 验证参数合法性
+```
+
+### Step 2: 执行对应 action
+
+根据 action 执行相应操作：
+
+#### action: status
+- 检查全局记忆目录（~/.autospec-global/autospec:memory/）状态
+- 检查项目记忆目录（.autospec/autospec:memory/）状态
+- 汇总并展示记忆系统状态
+
+#### action: show
+- 读取指定 layer（core/working/project/sessions）的记忆文件
+- 格式化展示记忆内容
+
+#### action: search
+- 在记忆目录中搜索匹配 query 的内容
+- 返回搜索结果列表
+
+#### action: add
+- 验证记忆类型（tech-stack/decision/constraint 等）
+- 将内容写入对应的记忆文件
+- 更新记忆索引
+
+#### action: update-north-star
+- 交互式引导用户填写北极星指标信息
+- 更新 .autospec/autospec:memory/north-star.json
+
+#### action: add-constraint
+- 验证约束内容
+- 写入项目或全局约束文件
+
+#### action: clean
+- 扫描过期记忆（超过保留期限）
+- 归档或删除过期内容
+- 生成清理报告
+
+#### action: export
+- 收集指定范围的记忆数据
+- 导出为 JSON 格式
+- 输出到 stdout 或文件
+
+#### action: import
+- 验证导入文件格式
+- 合并或替换现有记忆
+- 生成导入报告
+
+### Step 3: 输出结果
+
+- 格式化输出执行结果
+- 如有变更，显示变更摘要
+- 输出执行状态（成功/失败）
+
+---
+
+**继续执行**: 根据 action 结果继续后续流程