（9566期）Skill Father – OpenClaw 技能创作权威规范

OpenClaw 技能创作权威规范 制定 OpenClaw 技能创建权威标准，强制要求前置检查、可移植配置、引导式安装流程，确保技能跨机器可复现 使用说明 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）时，需严格限定作用域并提供回滚指引 交互死锁：聊天优先模式下，若用户长期不响应，需设计超时或后台降级机制 原始说明 Authoritative skill-creation standards (Boss). Use when creating or updating OpenClaw skills so they are portable, reproducible, include prerequisites checks...