@chongyan/autospec 1.0.1 → 1.0.3

package/plugins/commands/memory.md

@@ -1,249 +0,0 @@
----
-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 结果继续后续流程