Plan Keeper & AI Skill Tracker 联合协同规范

> 💡 定位说明：
> plan-keeper 与 ai-skill-tracker 为两个职责独立、松耦合的专业工具包。
> 本规范定义二者的联合工作流与数据协同标准，无需合并代码库即可实现「意图规划 + 技能度量 + 上下文唤醒」的开发闭环。

一、双系统职责边界与架构分工

┌────────────────────────────────────────────────────────────────────────┐
│                        AI Agent 运行时环境                             │
└──────────────────┬──────────────────────────────────┬──────────────────┘
                   │                                  │
      【骨架层：任务推进与记忆索引】          【度量层：效能追踪与经验唤醒】
          Plan Keeper CLI / 插件                AI Skill Tracker CLI
                   │                                  │
    ├─ 活跃看板: ./current-plan.md     ├─ 资产扫描: skill-tracker scan
    ├─ 任务档案: .plan-keeper/records/ ├─ 统计分析: skill-tracker stats
    ├─ 标签索引: .plan-keeper/index.md ├─ 可视看板: skill-tracker serve / report
    └─ 断点快照: ⏸ 暂停现场保存       └─ 记忆唤醒: 💡 项目历史技能画像
                   │                                  │
                   └────────────── 协同桥接 ──────────┘
                              (tracker_bridge)

二、四大标准协同阶段 (Closed-Loop Workflow)

阶段 1：项目立项与记忆唤醒 (Task Init & Memory Wake-up)

1. 触发时机：开启新需求、重构模块或跨会话进入项目。
2. 执行流程：
   - Agent 检查或创建 ./current-plan.md：
   sh plan-keeper init "任务名称" -g "一句话目标"
   - plan-keeper 通过内部 tracker_bridge 自动静默查询 ai-skill-tracker：
   sh skill-tracker stats --project "当前项目名" --limit 3
   - 若检测到往期高频技能，在回复首段追加记忆唤醒提示：
   > “💡 记忆唤醒：在「项目名」往期开发中，您曾高频使用 engineering-lite (12次)、windows-gbk-fix (5次)，相关最佳实践已就绪。”

阶段 2：步骤推进与技能匹配 (Step Execution & Telemetry)

1. 任务推进：
   - 每一个工作单元开发前，先在 current-plan.md 确认当前步骤。
   - 命中对应专业领域时，调用对应已安装技能（如代码重构调用 engineering-lite，单元测试调用 pytest）。
2. 被动感知：
   - ai-skill-tracker 异步扫描/解析会话 transcript，记录每个技能的触发频次、耗时与执行状态，无需人工干预。
3. 状态同步：
   - 步骤完成时运行：
   sh plan-keeper done <步骤ID> "完成结论与代码变动"
   - 自动在 .plan-keeper/records/<任务名>.md 记录日志并提取 [🔖 标签]。

阶段 3：断点暂存与无损恢复 (Snapshot & Seamless Resume)

1. 保存现场（任务切换、用户临时打断或会话即将退出）：
   sh plan-keeper snapshot -f "关注文件列表" -l "当前思维逻辑" -n "恢复后的第一步"
   - 自动在 current-plan.md 标记 ⏸ 搁置，生成 [🔖 快照: <任务名>_暂停_YYYYMMDD_HHMM] 标签并注册到全局索引。
2. 恢复现场：
   - 新会话开始时直接运行 plan-keeper status，读取快照 3 行信息秒级还原上下文。

阶段 4：方案归档与复盘度量 (Completion & Review Dashboard)

1. 方案归档：
   sh plan-keeper complete "整体交付总结"
2. 度量与复盘：
   - 查看本次任务或全项目的技能效能看板：
   sh skill-tracker report skill-tracker serve --port 8088
   - 统览哪些技能使用率高、哪些技能存在异常或缺乏测试覆盖，沉淀为团队最佳实践。

三、双工具常用命令速查

Plan Keeper 核心命令

AI Skill Tracker 核心命令

四、跨 7 大引擎适配标准

两者均遵循全量跨引擎适配标准，安装路径与规则如下（统一基于相对路径/用户主目录）：

五、环境安全与路径规范

1. 100% 相对路径：所有配置文件、文档与日志一律使用相对路径（./current-plan.md、~/.dsh/）或环境变量动态解析，禁止硬编码个人用户名或绝对盘符。
2. 数据脱敏：对外分享或提交 Git 仓库前，确认无 API Key、敏感 Token 或私人生产数据。