| name | skill-optimizer-lawvable |
| description | 分析当前工作会话并为技能提出改进建议的指南。用于 (1) 使用技能后自动捕获经验教训，(2) 当用户在技能相关会话中提出改进、更正或补充建议时，或 (3) 当用户手动调用 `self-improve` 时。 |
| metadata | {"author":"Malik Taiar (Lawvable)","license":"AGPL-3.0","version":"2026.01.07"} |
Self-Improve 技能
分析当前对话，并根据工作会话期间发现的更正、成功和边缘情况为技能提出改进建议。
触发
self-improve - 分析会话并提出改进建议self-improve [skill-name] - 针对特定技能self-improve on - 启用自动模式（钩子）self-improve off - 禁用自动模式self-improve status - 显示自动模式状态self-improve [skill-name] history - 显示修改历史
主工作流（self-improve）
第 1 步：识别技能
若未提供技能名称，列出 skills/ 目录中的可用技能并询问：
本次会话应分析哪个技能？
[列出 skills/ 目录中找到的技能]
第 2 步：检测信号
扫描对话以寻找信号——用户表达反馈的时刻：
| 信号类型 | 示例 |
|---|
| 更正 | “No”（不）、“That's not right”（那不对）、“It's missing X”（缺少 X）、“Always do Y”（总是做 Y）、用户重写输出 |
| 成功 | “Perfect”（完美）、“Yes”（是）、“Exactly”（正是如此）、用户无修改接受 |
| 边缘情况 | 用户需要变通方案、技能无法处理该请求 |
第 3 步：评估每个信号的质量
对每个更正信号，评估它是否能成为一条好的技能指令。
质量标准
1. 完整（COMPLETE）
指令包含应用它所需的全部信息。无需查其他资料或做假设。
| 等级 | 示例 |
|---|
| 通过 | “将输出结构化为：关键术语 / 风险领域 / 建议修订” |
| 失败 | “使用标准格式”（哪种格式？） |
| 失败 | “遵循我们事务所的准则”（什么准则？） |
2. 精确（PRECISE）
无模糊或主观术语。两个不同的人阅读该指令会有相同理解。
| 等级 | 示例 |
|---|
| 通过 | “将超过 12 个月的竞业禁止条款标记为高风险” |
| 失败 | “分析要更彻底” |
| 失败 | “让它对客户更合适” |
3. 原子性（ATOMIC）
一条指令解决单一要求。多项检查应拆分为独立指令。
| 等级 | 示例 |
|---|
| 通过 | “检查管辖法律条款” |
| 失败 | “检查管辖法律、管辖权和仲裁条款”（三项检查——拆分它们） |
4. 稳定（STABLE）
若引用法规或标准，指定版本或日期。指令应在任何时间阅读时以相同方式可评估。
| 等级 | 示例 |
|---|
| 通过 | “按我们内部政策 [政策名称和引用，日期为 2024 年 12 月 12 日] 审查终止条款。” |
| 失败 | “遵循最新市场标准”（哪些标准？会随时间变化） |
第 4 步：对信号分级
| 满足的标准 | 行动 |
|---|
| 全部 4 项标准通过 | 直接添加到技能 |
| 少于 4 项标准 | 请求澄清（参见第 5 步） |
第 5 步：请求澄清
当反馈未满足所有标准时，使用 AskUserQuestion 工具询问缺失内容：
我检测到一条更正，但需要更多信息才能改进技能。
您说："[用户的反馈]"
要创建更清晰的指令，我需要以下信息：
[列出基于失败标准的缺失内容的结构化工具调用]
若用户提供澄清 → 更新指令并继续到第 6 步。
若用户偏好原始内容 → 以原始指令继续到第 6 步。
第 6 步：提议变更
--- 学习：[skill-name] ---
拟议新增：
1. "[要添加的确切指令]"
来源："[对话引文]"
2. "[要添加的确切指令]"
来源："[对话引文]"
---
应用这些变更？[Y/n]
第 7 步：若获批准
-
更新 SKILL.md
- 读取
skills/[skill-name]/SKILL.md
- 在适当部分添加每条指令
- 每条指令必须可独立阅读和应用
-
更新 skills/[skill-name]/CHANGELOG.md
第 8 步：保存观察
对于无法处理的信号，提供保存选项：
保存这些观察供日后审阅？
- "[信号 1]" - 状态：[为何不足]
- "[信号 2]" - 状态：[为何不足]
若是，追加到 skills/[skill-name]/OBSERVATIONS.md
次要命令
self-improve on
- 运行：
rm -f ./.disabled
- 回复：“Automatic mode enabled.”（自动模式已启用。）
self-improve off
- 运行：
touch ./.disabled
- 回复：“Automatic mode disabled.”（自动模式已禁用。）
self-improve status
检查 .disabled 文件是否存在并报告。
self-improve [skill-name] history
- 显示 CHANGELOG.md 内容
- 询问：“Would you like to revert to a previous version?”（您想回退到先前版本吗？）
- 若是：
- 更新
skills/[skill-name]/SKILL.md 中的适当部分
- 在
skills/[skill-name]/CHANGELOG.md 中添加回滚说明
示例
示例 1：满足所有标准
用户说：“Always flag non-compete clauses over 12 months as high risk”（始终将超过 12 个月的竞业禁止条款标记为高风险）
评估：
- 完整：是 - 指令完全明确
- 精确：是 - “12 months”和“high risk”清晰
- 原子性：是 - 单一检查
- 稳定：是 - 无时间依赖
结果： 直接添加
示例 2：缺少标准
用户说：“Flag any non-market-standard indemnification clause”（标记任何非市场标准的赔偿条款）
评估：
- 完整：否 - “non-market-standard”未定义
- 精确：否 - “market standard”是主观的，因交易类型而异
- 原子性：是 - 单一检查
- 稳定：否 - 市场标准随时间演变
行动： 使用 AskUserQuestion 工具请求澄清：
我检测到一条更正，但需要更多细节。
您说："Flag any non-market-standard indemnification clause"
为使其可操作，您能否指定：
- 什么使赔偿条款成为"非市场标准"？（例如无上限责任、涵盖间接损失、无重大过失例外）
您想提供更多细节，还是按您陈述的方式添加该指令？
若用户澄清： 更新指令并添加。
若用户偏好原始内容： 按原样添加指令。
重要说明
- 绝不猜测用户的意思 - 不清楚时始终询问
- 绝不从上下文推断要求 - 它们必须明确
- 一条指令 = 一项检查 - 拆分捆绑的反馈
- 少数好的指令优于许多模糊的指令
- CHANGELOG.md 是面向用户的记录
