简化Skill

使用场景

当现有Skill的理解、操作、验证或维护难度超出其领域需求时，可使用本技能。请勿将其用于普通的纯代码清理工作。

预期结果

为指定的actor和任务至少降低一项已声明的复杂度成本。除非用户明确批准，否则需保留Skill的用途、权限、行为、安全性、依赖关系、输出和验证依据。

切勿仅以代码行数减少作为简化的依据。

硬性约束

将当前完整包作为基准事实来源。
保留必要的领域复杂度，优先消除非必要的偶发复杂度。
默认采用无损失变更。
严格保留精确的命令、路径、模式、哈希值、引号、权限控制、数值限制和终止规则。
区分组件状态与整个Skill的状态。
不要求来自每个模型或提供商的描述完全一致。
将确定性定义为封闭决策契约加上机器校验的最终状态。

必要组合

在修改包之前，请阅读依赖协调文档。当触发条件适用时，使用集合的起点、人类行为、agent行为和含义保留相关的所有者规则。

仅原生主机加载是一种证据，而非可移植依赖。需内化其不变量或路由到已安装的公共对等依赖。若两者均不可行，则返回

BLOCKED_DEPENDENCY

。

输入契约

记录

target

、

actor

、

task

、

environment

、

scope

、

invariants

、

measure

和

allowed_loss

。缺失数据用

unknown

表示。除非用户明确批准具体限制，否则

allowed_loss

默认为

none

。

状态机

仅按以下顺序执行：

DISCOVER -> BASELINE -> CONTRACT -> SELECT -> REWRITE -> VERIFY -> ACCEPT

若关卡失败，则进入

BLOCKED

状态。若存在未获批的损失，则进入

NEEDS_APPROVAL

状态。若未实现可接受的成本降低，则进入

NO_CHANGE

状态。

按以下优先级解决冲突：权限、安全与隐私、行为保留、用户指定的精确方法、更低的已声明成本，最后是

NO_CHANGE

。

操作流程

发现：读取实时目标、所有关联文件、相关所有者、来源记录、检查项和管控源。若发现无法解释的偏差则停止。
冻结：备份并哈希所有文件。运行现有检查项和代表性任务。
契约化：为每条规则和可观测行为分配稳定ID。记录权限、优先级、条件、保护范围、目标和证据。覆盖率必须达到
```
1.0
```
。
选择策略：依次尝试
```
deduplicate
```
（去重）、
```
clarify
```
（澄清）、
```
reorder
```
（重排）、
```
progressive-disclosure
```
（渐进式披露）、
```
extract-child
```
（提取子Skill）、
```
simplify-code
```
（简化代码），最后是
```
approved-loss
```
（获批损失）。选用首个能降低已声明成本且无否决项的模式。
验证声明：在声称行为有所改进前，定义测试针对的人类或agent群体及目标测试。
重写：修改最小范围的所有者。使用平实语言，每句一条规则，明确命名actor，使用封闭状态词、默认值和精确终止条件。
代码处理：优先使用测试，将代码验证依据与指令验证依据分开。
验证：重新计算哈希值、账本覆盖率、保护范围、链接、元数据、加载情况、测试、包状态和最终状态回读结果。在同一环境中对比基准版本和候选版本。
接受或恢复：仅当已声明成本降低、所有不变量通过且无剩余否决项时，才接受变更。否则恢复原状或返回精确的阻塞状态。

子Skill提取

仅当子Skill具备以下条件时才创建：有独立触发条件、独立预期结果、明确接口、标准所有权、直接测试、父路由测试、预期复用价值高于协调成本，且负载图无环。切勿仅为减少代码行数而拆分。

验收标准

ACCEPT

状态需满足：

重新计算基准版本和候选版本的包哈希值；
账本覆盖率为
```
1.0
```
，且无未授权损失；
所有保护范围均通过检查或已获得明确批准；
在同一环境中至少一项已声明成本降低；
原生、任务、包、链接和回读检查均通过；
全部10个原生压力测试用例均保留其要求和禁止的行为。

包通过、评估注册、行为评估通过、组件状态和整个Skill通过是各自独立的结果。

参考资源

简化模型
保留契约
依赖协调
```
assets/
```
目录包含账本模板
```
examples/
```
目录包含已接受和阻塞的结果示例
```
evals/
```
目录包含原生用例谱系和可移植测试
```
scripts/
```
和
```
scripts/tests/
```
目录包含包检查脚本

simplify-skill

NPX安装

标签

SKILL.md 内容（中文）