Skill Father

Skill Father：OpenClaw 技能创作权威规范

Skill Father 是由 Boss 制定的权威性技能创建与更新标准，旨在解决技能碎片化、配置硬编码、安装体验不一致等核心问题。该规范强制要求所有技能遵循四大支柱：前置检查（Prerequisites）、可移植配置（Portable Config）、引导式安装（Onboarding）、可复现性（Reproducibility）。

核心用法与强制规范

#### 1. 前置检查（Fail Fast）
每个技能必须在开头声明硬性依赖，例如 op whoami 验证 1Password 登录状态、command -v <tool> 检测 CLI 存在性。不允许假设环境已就绪，必须提供明确的安装指引。

#### 2. 可移植配置（双文件模式）
严禁在 SKILL.md 中硬编码机器专属路径、令牌、租户 ID。强制采用分离式配置：

• config.env.example / config.json.example：版本控制的示例模板，永不被修改
• config.env / config.json：机器专属真实值，由安装流程生成/更新

SKILL.md 必须文档化配置位置、必填键、默认值及安装命令。

#### 3. 引导式安装/初始化

• 聊天优先（Chat-first）：针对 Telegram 等无 TTY 场景，Agent 必须在聊天中询问用户、写入配置、执行冒烟测试
• 终端可选（Terminal）：交互式脚本仅作为本地终端的便利补充
• 配置编辑安全：修改系统文件（如 ~/.ssh/config）时，必须逐项对比当前值与新值，让用户选择保留/覆盖/跳过，敏感值需脱敏显示

#### 4. 可复现性
技能应在其他机器上最小修改即可运行，优先使用参数化配置+用户提示，避免隐式环境假设。

#### 5. 资源布局标准

skill-name/
├── SKILL.md
├── config.env.example    # 共享示例
├── config.env            # 机器专属（生成）
├── scripts/              # 确定性代码
└── references/           # 按需加载文档

显著优点

| 维度 | 价值 |

|------|------|

| **标准化** | 终结技能风格混乱，降低用户学习成本 |

| **可移植** | 技能可在团队/机器间无缝共享，配置与代码分离 |

| **安全** | 敏感值不入版本控制，安装流程强制确认关键操作 |

| **鲁棒性** | 前置检查避免运行时失败，冒烟测试快速验证 |

| **多场景适配** | 聊天优先设计覆盖 GUI 环境，非终端用户友好 |

潜在局限与风险

| 局限 | 说明 |

|------|------|

| **创作成本** | 相比随意编写，需额外设计配置结构、编写检查逻辑、维护示例文件 |

| **规范学习曲线** | 新作者需理解双文件配置、聊天优先等概念 |

| **过度工程风险** | 简单一次性技能可能无需完整流程，存在规范重量与敏捷性的权衡 |

| **Agent 依赖** | 聊天优先模式依赖 Agent 正确执行配置写入，需验证文件权限和路径安全 |

适合人群

• 技能作者：希望技能被团队广泛采用、减少支持负担的开发者
• 团队管理员：需要标准化内部工具、确保配置安全合规的 Tech Lead
• 平台运营：构建技能生态、提升整体质量的 OpenClaw 维护者

常规风险

• 配置泄露：若误将 config.env 提交至版本控制，可能导致敏感凭证暴露；需配合 .gitignore 模板强制排除
• 权限失控：安装脚本修改系统级配置（如 SSH、systemd）时，需严格限定作用域并提供回滚指引
• 交互死锁：聊天优先模式下，若用户长期不响应，需设计超时或后台降级机制

核心用法

Skill Father 是一份纯文档型的权威开发规范，用于指导 OpenClaw 技能的创建与更新流程。它不执行任何代码，而是作为"技能之父"为其他技能提供标准化模板。核心用法包括：

1. 创建新技能时：遵循其定义的五大必需模块——Prerequisites（前置条件检查）、Configuration（可移植配置）、Initialization/Onboarding（引导式初始化）、Reproducibility（可复现性保障）、Executables（本地化管理）。

2. 更新现有技能时：对照检查清单验证是否符合规范，特别是配置分离原则（config.env.example vs config.env）和聊天优先的 onboarding 模式。

3. 代码生成辅助：作为 Agent 的知识库，指导其生成符合规范的结构化代码、脚本和文档布局。

显著优点

• 标准化程度高：明确了从 Prerequisites 到 Executables 的完整开发链路，减少技能间的质量差异。
• 可移植性设计：强制要求机器特定配置外置，避免硬编码路径、密钥等，使技能可在不同环境间无缝迁移。
• 用户体验友好：推崇"聊天优先"的 onboarding 模式，适配 Telegram 等异步聊天场景，降低用户配置门槛。
• 渐进式披露：SKILL.md 保持简洁，详细文档放入 references/，代码放入 scripts/，结构清晰。
• 复现性保障：通过配置参数化 + 用户确认机制，确保技能在多机器、多用户场景下行为一致。

潜在缺点与局限性

• 约束力有限：作为文档规范而非强制框架，实际遵守程度依赖开发者自觉性。
• 学习成本：对新手而言，config 分离、onboarding 脚本设计等概念需要一定理解时间。
• 场景覆盖不全：当前规范主要针对 CLI/系统工具类技能，对纯 API 集成、AI 模型调用等场景的针对性指导较弱。
• T3 来源风险：由个人开发者维护，无知名组织背书，规范的长期稳定性和更新保障存在不确定性。

适合的目标群体

• OpenClaw Skill 开发者：尤其是希望其作品被社区广泛采用的专业开发者。
• DevOps/平台工程师：需要为团队构建标准化内部工具链的技术负责人。
• 技术文档撰写者：关注技能可维护性和用户体验的写作规范爱好者。
• Agent 框架设计者：研究 Skill 生命周期管理和配置最佳实践的架构师。

使用风险

• 规范理解偏差：Agent 可能误解"聊天优先"等抽象概念，生成不符合预期的交互逻辑。
• 配置管理失误：config 分离机制若实现不当，可能导致敏感信息意外提交至版本控制。
• onboarding 脚本安全：规范指导生成的脚本可能涉及系统级修改（如 SSH 配置、systemctl 操作），需人工审查后再执行。
• 依赖平台生态：Skill 的可用性绑定 OpenClaw 平台，若平台演进方向变化，规范可能过时。
• 许可证缺失：当前未声明开源许可证，商业使用存在法律合规不确定性。