auto-commit-memory

---
name: auto-commit-memory
description: |
  自动总结当前对话并提交为团队记忆(team-memory)。  当用户说"提交下"、"提交一下"、"存一下"、"把这个存下来"、"记一下"、"沉淀一下"等类似表达时, 触发本 skill。
  流程: 分析对话 → 提取背景/结论/要点/案例/使用场景 → 判断记忆类型 → 展示总结草稿 →
  问"是否提交" → 仅当用户回复确认词(是/可以/行/确认/ok/yes/y/提交/好/对)才执行
  team-memory save(一条命令完成 capture + git commit)。绝不未经确认就提交。
---

# 自动总结并提交记忆

## 记忆仓库（唯一合法位置）

**数据仓库路径**: `{root}`

**Git 远端**: `{memory_remote}`（`team-memory` 数据仓库, **不是** `agent-team-memory` 工具仓库）

**默认作者**: `{author}`

## 禁止事项（违反会导致 Web/队友看不到）

1. **禁止**在 `agent-team-memory` 工具仓库里创建/修改任何 `.md` 记忆文件
2. **禁止**写入工具源码目录 `team_memory/memory/`（那是 Python 包, 不是记忆仓库）
3. **禁止**手动 `write`/`edit` 新建记忆文件 — 必须用下方 `save` 命令
4. **禁止**在工具仓库目录里 `git add` / `git commit` 来存团队记忆
5. **禁止**省略 `-p "{root}"` — 即使用户当前打开的是工具仓库项目

## 何时触发

用户说出以下任一(或语义相近)时触发:
- "提交下" / "提交一下" / "存一下"
- "git 上面的内容" / "把上面的提交"
- "总结提交" / "总结一下提交"
- "把这个存下来" / "记一下" / "沉淀一下"

> **Claude Code 用户**: 本能力由 `~/.claude/skills/auto-commit-memory/SKILL.md` 提供。
> **不要**在 `.claude/settings.json` 配 hooks — hooks 无法总结对话, 且易误用 `capture` 写错仓库。

## 执行流程

### 1. 回顾对话, 定位核心
找到本次对话要解决的核心问题 / 任务 / 决策。如果对话很长, 聚焦最近的主题。

### 2. 提取并总结(记忆是压缩的共识, 不是全文转录)

按以下结构提炼(缺失的项可省略):

- **背景**: 为什么会有这个问题(1-2 句)
- **结论**: 最终的答案 / 决定 / 方案(这是核心)
- **要点**: 关键步骤 / 参数 / 约束 / 数据(分条列出)
- **案例**(如有): 具体的命令 / 代码 / 输入输出(**用代码块, 保证可复制**)
- **使用场景**: 什么情况下会再用到这个知识(写成触发条件, 便于以后检索召回)

### 3. 判断记忆类型(五选一)

| 情况 | 类型 |
|------|------|
| 技术选型 / 架构决定 | `decision` |
| 解决了非平凡错误 | `error` |
| 验证了可复用流程 / 概念笔记 | `skill` |
| 项目 / 架构信息 | `project` |
| 代码结构 / 坑点 | `code` |

### 4. 展示总结草稿(**先不提交**)

用清晰格式把以下内容展示给用户:

```
标题: <一句话标题>
类型: <decision/error/skill/project/code>
来源: <你当前正在用的工具: claude/codex/hermes/trae/cursor>
---
背景: ...
结论: ...
要点: ...
案例: ...
使用场景: ...
```

### 5. 征求确认

明确问一句:

> **是否提交?**(回复 "是 / 可以 / 行 / 确认 / ok" 提交; "不 / 算了 / 取消 / 再改改" 取消)

### 6. 根据用户回复执行

- **确认词**(是 / 可以 / 行 / 确认 / ok / yes / y / 提交 / 好 / 对 / 嗯) → **只执行下面这一条命令**:

```bash
{python} -m team_memory save "<标题>" -t <类型> --via <当前工具> -a {author} -p "{root}" --note "<总结正文>"
```

  如需立即推送到 Git 远端, 在用户明确要求同步时加 `--sync`:

```bash
{python} -m team_memory save "<标题>" -t <类型> --via <当前工具> -a {author} -p "{root}" --note "<总结正文>" --sync
```

  完成后告知: 记忆 id、文件路径、记忆仓库 `{root}`。提醒 Web 地址 `{web_url}` 刷新可见。

- **否定词**(不 / 算了 / 取消 / 不要 / 再改改 / 等等) → 不提交, 回复 "已取消, 调整后可再说'提交下'"。

- **模糊**(只回了个"嗯?"或无关内容) → 再问一次, 要求明确的确认或否定。

## 铁律

1. **必须等用户明确确认才提交**, 绝不自动提交、绝不跳过确认步骤。
2. **只用 `save` 命令**, 不要拆成 capture + 手写文件 + 在错误仓库 git commit。
3. 总结要**精炼**, 突出可复用价值——删掉寒暄、试错过程、临时输出, 只留共识。
4. 案例必须保留**可复制格式**(代码块)。
5. `--via` 填**当前正在用的工具名**, 保证来源可追溯。
6. 若 `save` 报「工具仓库」或「找不到记忆仓库」, 提示用户先运行 `python scripts/onboard.py <team-memory.git> <短名>`。