把重复方法
整理成一个 Skill

先理解今天的原理

Skill 保存稳定的执行方法，项目规则保存长期边界，本次任务提供变化的目标和材料。三者分开后，方法可以复用，同时不会把某个项目的具体内容写死。

一个可靠 Skill 需要说明何时触发、需要什么输入、按什么步骤执行、生成什么产出、遇到什么情况停止。正向测试检查能否完成，失败测试检查它会不会在缺少证据时乱补。

为什么今天要做这件事

1. 重复方法写成 Skill 后，新任务无需重新解释所有步骤。
2. 明确停止条件可以减少虚构结果和越权操作。
3. 正向与失败测试能证明它在正常和异常输入下都可控。

开始前检查

这是第 06 天。先完成下面的检查，再开始操作。缺少关键材料时，先补材料，不要让 Agent 猜。

1. 选择已经真实执行至少一次的方法。
2. 准备一份合格交付证据和一份缺少证据的测试材料。
3. 确认 Skill 不包含密钥、个人路径或生产账号。

一步一步完成

第 1 步：写一句准确的触发条件

这一步会生成后续课程继续使用的材料。文件名、保存位置和内容边界需要写清楚，让第二天重新打开项目时仍然知道它的用途。

1. 写一句准确的触发条件。
2. 打开新材料逐项检查，删除示例占位内容，补上本次真实信息。
3. 记录保存路径，并确认关闭页面或重新打开项目后仍能找到。
4. 对照今天的目标检查这一项，发现偏差时先处理偏差，再进入第 2 步。

完成这一步后，你应该看到：写一句准确的触发条件，产物内容完整并且可以重新找到。

第 2 步：列出必需输入和缺失输入时的处理

这一步包含一次判断。请保留候选项、判断标准和最后选择，后面发现方向不合适时才能回看当时依据。

1. 列出必需输入和缺失输入时的处理。
2. 写下至少一个未选方案及其未被采用的原因。
3. 用一句话说明最终决定，并列出会改变这个决定的新证据。
4. 对照今天的目标检查这一项，发现偏差时先处理偏差，再进入第 3 步。

完成这一步后，你应该看到：列出必需输入和缺失输入时的处理，选择依据和排除原因都能够被复查。

第 3 步：把流程压缩成可观察的步骤

先把这一项单独完成，再继续后面的动作。操作过程要留下可以检查的材料，方便发现偏差时回到当前步骤。

1. 把流程压缩成可观察的步骤。
2. 记录输入、实际动作和得到的结果。
3. 对照今日目标检查；结果不一致时，先保存证据并处理当前问题。
4. 对照今天的目标检查这一项，发现偏差时先处理偏差，再进入第 4 步。

完成这一步后，你应该看到：把流程压缩成可观察的步骤，过程与结果均有可复查证据。

第 4 步：规定产出文件、字段和保存位置

这一步会生成后续课程继续使用的材料。文件名、保存位置和内容边界需要写清楚，让第二天重新打开项目时仍然知道它的用途。

1. 规定产出文件、字段和保存位置。
2. 打开新材料逐项检查，删除示例占位内容，补上本次真实信息。
3. 记录保存路径，并确认关闭页面或重新打开项目后仍能找到。
4. 对照今天的目标检查这一项，发现偏差时先处理偏差，再进入第 5 步。

完成这一步后，你应该看到：规定产出文件、字段和保存位置，产物内容完整并且可以重新找到。

第 5 步：分别运行合格输入、无关任务和缺少证据三种测试

这一步会让环境或项目发生变化。开始前先保存当前状态，执行时记录真实入口、参数和输出，出现异常就停在当前步骤排查。

1. 分别运行合格输入、无关任务和缺少证据三种测试。
2. 保存执行命令、输入参数、开始前状态和结束后的输出。
3. 重新运行一次最小检查，确认结果可以稳定复现。
4. 对照今天的目标完成最后检查，确认所有证据已经保存。

完成这一步后，你应该看到：分别运行合格输入、无关任务和缺少证据三种测试，执行过程与可复现结果已经记录。

# 交付报告 Skill

## 触发
当用户明确要求为已完成任务生成交付报告时使用。

## 必需输入
- 最终结果路径
- 已运行的检查及结果
- 已知限制

## 步骤
1. 核对结果文件存在。
2. 读取实际检查结果。
3. 汇总修改、验证和限制。
4. 写入 DELIVERY.md。

## 停止条件
缺少结果或检查证据时，列出缺失项并停止。

# 第 06 天操作记录

## 今天使用的入口与版本

## 实际完成的步骤
- [ ] 1. 写一句准确的触发条件。
- [ ] 2. 列出必需输入和缺失输入时的处理。
- [ ] 3. 把流程压缩成可观察的步骤。
- [ ] 4. 规定产出文件、字段和保存位置。
- [ ] 5. 分别运行合格输入、无关任务和缺少证据三种测试。

## 保存的证据
- 文件：
- 截图：
- 命令或测试结果：

## 与文章不同的地方

## 下一步

这次真实操作得到了什么

1. safe-reversible-change 在项目内 venv 完成校验；允许文件测试 PASS，越界文件测试 FAIL。

本次实际结果：Skill 没有安装进用户全局目录，项目依赖可以单独清理重建。

正确结果长什么样

完成操作后，用结果来判断今天是否学会。页面能打开或命令能运行，只能说明流程启动了；下面这些证据同时出现，今天才算完成。

1. 合格任务可以正确触发并生成规定产出。
2. 无关任务保持原流程，不触发这项 Skill。
3. 缺少检查证据时，系统列出缺失项并停止。
4. Skill 中没有写死个人路径、账号或某次项目内容。

常见错误与恢复

留给明天的材料

结束前把今天的关键结果保存到项目目录。下一天会直接使用这些材料，保存清楚可以减少重复说明和错误猜测。

1. 一个经过三类测试的 Skill。
2. 正向、误触发和失败测试记录。
3. 产出示例与停止条件。