---
name: capture
description: 复刻一次成功任务的经验，输出到用户指定目录。调用方式 `/capture <目录>` 或 `$capture <目录>`，生成只含 fenced YAML 的 Markdown 记录。
---

# Capture - 成功经验复刻

> **定位**：把当前会话里已经跑通、值得复用的做法沉淀成结构化记录，供其他仓库直接复刻。

当用户调用 `capture` skill、`/capture <target_dir>`、`$capture <target_dir>`，或自然语言要求“把这次成功经验沉淀/复刻到某个目录”时，执行以下步骤。

## 1. 锁定输出目录

- 如果用户给了目录，直接使用。
- 绝对路径原样使用；相对路径相对当前仓库根目录。
- 如果没给目录，只追问一次：`要保存到哪个目录？`
- 目录不存在就创建。

## 2. 收集事实

只从这些来源取材：

- 当前会话里的目标、决策、问题、修复、验证结果
- 当前任务产物、相关文件、diff、日志
- 明确发生过且已经验证的修复

不要做这些事：

- 不复述用户原需求
- 不编造未知信息
- 不把“计划中但没发生”的内容写成事实

## 3. 生成记录

### 3.1 命名

- `task` 用任务本质的短名字，避免 `misc`、`update-doc` 这类空名。
- 文件名：`YYYY-MM-DD-task-slug.md`
- 若重名，依次追加 `-2`、`-3`

### 3.2 内容规则

- 文件内容只能有一个 fenced code block，语言标记固定为 `yaml`
- code block 外不要写任何文字
- `raw_request` 只写归一化摘要；拿不准就留空
- 空标量字段留空
- 空列表字段写 `[]`，不要保留空 `-`
- 每个 bullet 尽量控制在两行内
- 重点写：目标、输入输出、必须正确项、风险、关键决策、问题修复、成功原因、可复用模式
- `why_it_worked` 只写真正起作用的因素
- `reusable_pattern` 必须可执行，优先写先做什么、看什么、按什么顺序复用
- `problems_and_fixes` 只写实际发生且已验证的项

### 3.3 固定模板

~~~~markdown
```yaml
task: <task_name>

goal: >
  <一句话目标>

context:
  scene:
  trigger:
  audience:
  deadline:
  constraints:
    -

input:
  raw_request:
  known:
    -
  unknown:
    -
  dependencies:
    -

output:
  deliverable:
  consumer:
  usage:
  acceptance:
    -

must_be_right:
  -

can_be_rough:
  -

risks:
  -

decisions:
  - choice:
    reason:

execution:
  -

problems_and_fixes:
  - problem:
    symptom:
    cause:
    fix:
    status:

why_it_worked:
  -

reusable_pattern:
  first_step:
  checkpoints:
    -
  reusable_steps:
    -
  anti_patterns:
    -

one_line_summary: >
  <一句话总结为什么成功>
```
~~~~

如果某个列表字段没有内容，改成 `[]`。如果某个标量字段没有内容，保持为空，不要删字段。

## 4. 保存和回执

- 保存到目标目录，不覆盖同名旧文件
- 默认不把全文再贴回对话，除非用户明确要求
- 回执只说三件事：保存路径、任务名、提醒主人还应该准备一个单独“保存味道”的地方

## 注意事项

- 本 skill 只沉淀记录，不修改业务代码
- 信息不足时允许留空，但不要跳过关键字段
- 如果任务结果并不成功或还没稳定，不要硬写成“成功经验”