name	skill-creator
description	元Skill——创建和管理Skill。先查已有Skill再动手，复用优先，省token。写完的Skill通用、可复用、文档清晰。
disable-model-invocation	false

Skill Creator

> 你是Skill的创造者，不是代码的搬运工。 优先发现和复用已有Skill，只在必要时新建。

工作流程

1. 先查已有Skill（最高优先级）

用 list_files /sdcard/Download/Operit/skills/ 看目前已安装的Skill
用 grep_code 搜索现有 SKILL.md 的 frontmatter（name/description），找功能相似的
用 grep_context 做语义搜索，匹配任务意图
若有现成Skill能直接用的 → 调用它完成任务
若部分匹配需扩展 → 读原Skill，修改后保存新版本

2. 没有才建新的

新建Skill的标准结构：

skills/<skill-name>/
├── SKILL.md          ← 必需，含 frontmatter
└── （可选附带文件：脚本、模板、配置）

3. SKILL.md 最佳实践

Frontmatter（必需）：

---
name: skill-name           # 小写字母+连字符
description: 一句话说明     # AI会根据这个决定是否调用
disable-model-invocation: false  # 让AI自主判断
---

正文主结构：

开头引用块 → 一句话告诉AI这个Skill的定位
工作流程 → 分步骤，每步说清「先做什么、用什么工具」
约束 → 禁止事项单独列出

三条铁律：

指令，不是教程：告诉AI「怎么做」，不解释「为什么」
可复用：Skill要通用，不绑定特定项目/路径
省token：每个字都要有存在理由，砍掉所有废话

Skill 3.5.1：免免蒸馏扩展——传染性硬编码 + 系统沉默（2026-07-09）

来自 Search Vault v4.4.0 硬编码松绑实战 + 綦桐网关无前缀消息静默链。

新增两步审码

第六步：传染性检查 — 「这个值改了，谁还依赖同一个假设？」不是某一个硬编码有问题——是多个硬编码互相引用同一套不合理假设。改了 default_num，引擎上限没改。改了返回格式，熔断阈值没跟。问：改一个值时，哪些地方依赖同一个隐含前提？

第七步：系统沉默 — 「这条错误路径上，有没有谁吞了信息？」不是某一个 catch 块空了——是整条错误链上多个组件共用"不出声"这个默认行为。loadSettings缓存失效不报、Firecracker空结果不报、keys_add重复静默失败。问：从出错点到用户看到反馈，中间每个组件有没有把错误往下传？

Skill 3.5：免免蒸馏——四件套审码 + 四原则架构（2026-07-09）

来自 kotlin-head v0.5.2→v0.12.8 全版本 bug 回溯 + 三层架构改革。以后写任何 Skill 牢记五步审码和四原则。

审码五步（写 Skill 时自检）

符号解析：Skill 里每个字段名、函数名——声明时的定义和运行时一致吗？
前提检查：Skill 里的 if/when 条件——前提在当前上下文还成立吗？
数据流：Skill 引用的状态——被读之前有没有别的步骤改过？
控制流+值域：Skill 的每条分支——有没有路能走到？支配域覆盖全了吗？
身份检查：这个 Skill 的每个步骤——只干一件事还是混了多种身份？

架构四原则（设计新 Skill 时应用）

手搓节点：Skill 的每个概念从出生就有消费者。不让 Parser 生成尸体节点。
探针用 id 不用名字：不依赖字符串匹配。身份不随名字变化。
适配层：外部格式不进核心。Parser 只吃原生格式。
组件不塌缩：每个步骤一种身份。不让一个步骤变全能。

验证

kotlin-head 全版本免免亲自发现的 17 个 bug，五步审码 100% 覆盖。不是方法论——是编译器前端四阶段。

Skill 3.4：kotlin-head v0.11.x 实战教训

来自 kv2.6 在编译器中元编程反哺架构的经验。每条教训写 Skill 时牢记。

架构太好也是错：自动匹配需双向验证。选了最强的≠最优解——过度匹配和匹配不足一样是bug。
注释数字腐烂：枚举值旁的计数永远不会自动同步。Skill 里写数字必须加断言验证步骤。
静态模板有上限：30条模板→不够。查表方案在维度交叉前必被撑爆。定义推导规则替代列清单。
Dead Code 活 bug：重构后旧接口不报警。Skill 里的步骤删功能时顺手删旧步骤。
被动路径别降级：主动/被动双模式必须用同一套逻辑。被动不能走默认行为。
审计反馈需常识过滤：技术上对≠实际有意义。Skill 的约束必须区分"理论风险"和"实际触发条件"。

4. 完成后存档

新建的Skill放到 /sdcard/Download/Operit/skills/，确认 SKILL.md 在文件夹根目录。

可用工具

Operit原生支持三类工具包，写Skill时按需选：

类型	用途	示例
MCP	外部服务/API（如搜索、数据库）	`tavily_search`、`haven_mcp`
Skill	指令模板（元层指导）	`setup-matt-pocock-skills`、`writing-great-skills`
沙盒包	JS脚本工具	`various_search`、`file_converter`

Skill本身不提供工具——它告诉AI「用哪个工具、怎么用」。

Más de este repositorio

mismo repositorio

head-worker-skills

yimian-521/head-worker-skills

元Skill——创建沙盒包（v3.5.5）。先陪人看清自己真正的愿望、再判断形态、区分普通JS与ToolPkg、再探索现状、对照通用Bug与优化清单自由判断、逐步与用户确认抉择，最后进入平台的沙盒包开发工具撰写流程。兼容层级、按类型性能准则、QuickJS陷阱全内置。内置形态区别表、第一次创建必读清单。附带file-head五军文件操作沙盒（Node.js零依赖，分页翻书+SCOUT侦察+军师摘要）。仅在用户明确表达"想做沙盒包/工具/脚本"或主动要求了解沙盒包概念时触发。

2026-07-091

mianmian-review

yimian-521/head-worker-skills

免免八步审码——编译器前端管线直觉式审计。不分类、不命名、不列清单。全语言通用（Kotlin/Python/JS/Rust/Go/...）。八步：符号解析→前提检查→数据流→控制流+值域→身份检查→传染性→系统沉默→硬限制分析。元Skill：审码之前先读这个。

2026-07-091

operit-meta-guide

yimian-521/head-worker-skills

Operit元认知指南——AI醒来后的第一份地图。何时用Skill/MCP/沙盒包，三个元Skill各自干什么，记忆系统怎么用，遇到未知任务怎么自举。Use when you don't know what tool to use, when the task spans multiple systems, or when you need to understand how Operit pieces fit together.

2026-07-081

name	skill-creator
description	元Skill——创建和管理Skill。先查已有Skill再动手，复用优先，省token。写完的Skill通用、可复用、文档清晰。
disable-model-invocation	false

Skill Creator

> 你是Skill的创造者，不是代码的搬运工。 优先发现和复用已有Skill，只在必要时新建。

工作流程

1. 先查已有Skill（最高优先级）

用 list_files /sdcard/Download/Operit/skills/ 看目前已安装的Skill
用 grep_code 搜索现有 SKILL.md 的 frontmatter（name/description），找功能相似的
用 grep_context 做语义搜索，匹配任务意图
若有现成Skill能直接用的 → 调用它完成任务
若部分匹配需扩展 → 读原Skill，修改后保存新版本

2. 没有才建新的

新建Skill的标准结构：

skills/<skill-name>/
├── SKILL.md          ← 必需，含 frontmatter
└── （可选附带文件：脚本、模板、配置）

3. SKILL.md 最佳实践

Frontmatter（必需）：

---
name: skill-name           # 小写字母+连字符
description: 一句话说明     # AI会根据这个决定是否调用
disable-model-invocation: false  # 让AI自主判断
---

正文主结构：

开头引用块 → 一句话告诉AI这个Skill的定位
工作流程 → 分步骤，每步说清「先做什么、用什么工具」
约束 → 禁止事项单独列出

三条铁律：

指令，不是教程：告诉AI「怎么做」，不解释「为什么」
可复用：Skill要通用，不绑定特定项目/路径
省token：每个字都要有存在理由，砍掉所有废话

Skill 3.5.1：免免蒸馏扩展——传染性硬编码 + 系统沉默（2026-07-09）

来自 Search Vault v4.4.0 硬编码松绑实战 + 綦桐网关无前缀消息静默链。

新增两步审码

Skill 3.5：免免蒸馏——四件套审码 + 四原则架构（2026-07-09）

来自 kotlin-head v0.5.2→v0.12.8 全版本 bug 回溯 + 三层架构改革。以后写任何 Skill 牢记五步审码和四原则。

审码五步（写 Skill 时自检）

符号解析：Skill 里每个字段名、函数名——声明时的定义和运行时一致吗？
前提检查：Skill 里的 if/when 条件——前提在当前上下文还成立吗？
数据流：Skill 引用的状态——被读之前有没有别的步骤改过？
控制流+值域：Skill 的每条分支——有没有路能走到？支配域覆盖全了吗？
身份检查：这个 Skill 的每个步骤——只干一件事还是混了多种身份？

架构四原则（设计新 Skill 时应用）

手搓节点：Skill 的每个概念从出生就有消费者。不让 Parser 生成尸体节点。
探针用 id 不用名字：不依赖字符串匹配。身份不随名字变化。
适配层：外部格式不进核心。Parser 只吃原生格式。
组件不塌缩：每个步骤一种身份。不让一个步骤变全能。

验证

kotlin-head 全版本免免亲自发现的 17 个 bug，五步审码 100% 覆盖。不是方法论——是编译器前端四阶段。

Skill 3.4：kotlin-head v0.11.x 实战教训

来自 kv2.6 在编译器中元编程反哺架构的经验。每条教训写 Skill 时牢记。

架构太好也是错：自动匹配需双向验证。选了最强的≠最优解——过度匹配和匹配不足一样是bug。
注释数字腐烂：枚举值旁的计数永远不会自动同步。Skill 里写数字必须加断言验证步骤。
静态模板有上限：30条模板→不够。查表方案在维度交叉前必被撑爆。定义推导规则替代列清单。
Dead Code 活 bug：重构后旧接口不报警。Skill 里的步骤删功能时顺手删旧步骤。
被动路径别降级：主动/被动双模式必须用同一套逻辑。被动不能走默认行为。
审计反馈需常识过滤：技术上对≠实际有意义。Skill 的约束必须区分"理论风险"和"实际触发条件"。

4. 完成后存档

新建的Skill放到 /sdcard/Download/Operit/skills/，确认 SKILL.md 在文件夹根目录。

可用工具

Operit原生支持三类工具包，写Skill时按需选：

类型	用途	示例
MCP	外部服务/API（如搜索、数据库）	`tavily_search`、`haven_mcp`
Skill	指令模板（元层指导）	`setup-matt-pocock-skills`、`writing-great-skills`
沙盒包	JS脚本工具	`various_search`、`file_converter`

Skill本身不提供工具——它告诉AI「用哪个工具、怎么用」。