140 lines
3.2 KiB
Markdown
140 lines
3.2 KiB
Markdown
---
|
|
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 只沉淀记录，不修改业务代码
|
|
- 信息不足时允许留空，但不要跳过关键字段
|
|
- 如果任务结果并不成功或还没稳定，不要硬写成“成功经验”
|