前言¶
写 Agent Skill 的常见路径是先搜「SKILL.md 怎么写」，再翻平台文档找部署方式，接着在测试和优化阶段继续查资料。知识分散在 Anthropic 规范、OpenClaw 部署文档、ClawHub 商店说明里，版本和术语还不一致。这个 Skill 把这些内容按流程组织成一套可跟随的说明，减少来回检索。
这是什么¶
「智能体技能配置指南」是一个知识型 Skill，坐标 @user_148deca1/agentskills-complete-guide，由社区发布者 user_148deca1 维护，版本 1.0.1，分类 ai-agent。它定位是 AI Agent Skills 的全栈指南：从概念原理、Anthropic 开发规范，到 OpenClaw 部署架构，覆盖技能从创建到发布的完整链路。它不替代各平台官方文档，也不负责具体编码。
触发方式与覆盖范围¶
按官方说明，它在用户提到以下话题时触发：创建技能、Skill 开发、Agent Skills、SKILL.md、触发器、Hook、渐进式披露、500 行规则、技能部署、ClawHub、OpenClaw 配置、技能测试、技能优化、技能商店、MCP、护栏技能、领域技能、执行级别、会话跟踪、技能加载、技能发布、技能注册表、skill-rules、技能调试。
明确不适用于三类情况：非技能开发领域的通用编程问题；商业产品级技能的全权代劳；各平台官方文档的完整替代。
核心内容¶
按官方描述，指南的主线是：
- 概念与原理：解释技能是什么、执行级别、会话跟踪、技能加载、渐进式披露、触发器、Hook。
- 开发规范：SKILL.md 的写法、500 行规则、skill-rules、护栏技能与领域技能的区分。
- 测试与优化：技能调试、技能测试、技能优化的通用流程。
- 部署与发布：技能部署、OpenClaw 配置、技能注册表、技能商店、ClawHub、MCP 接入。
它属于知识库型 Skill，实际产出是结构化的说明与检查清单，而不是可运行代码。
安装与启用¶
已抓取资料只给出了 SkillHub 坐标和标签 requires_api_key=false，没有提供标准安装命令或目录约定。因此这里不写未经核实的 curl 或 npm 命令。可用入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_148deca1/agentskills-complete-guide
- 官方地址：https://api.skillhub.cn/user_148deca1/agentskills-complete-guide
- 来源归属：community（社区），
ai-agent分类，发布者user_148deca1
在支持该注册表的客户端里按坐标安装即可。是否需要 API Key 的字段在资料中标记为 requires_api_key=false。Cursor、Codex CLI、Claude Code 的安装差异，资料中没有给出，这里不做区分说明。
典型用法¶
资料里没有提供可复现的命令行示例或代码片段，以下为按官方描述推导的使用方式，不是官方原文。
按创建技能的流程，可以这样使用：
1. 让 Skill 给出 SKILL.md 的字段结构与 500 行规则的判定标准
2. 让它给出触发器与 Hook 的配置要点
3. 按 OpenClaw 部署架构准备目录与注册表项
4. 用它的测试与优化清单逐项核对
5. 按技能商店 / ClawHub 的要求准备发布材料
在提问时把问题限定在技能开发范围内，例如「渐进式披露在 SKILL.md 里怎么体现」「技能调试的检查顺序是什么」，得到的说明会更贴合指南范围。
适用场景与注意¶
适合这几类人：第一次写 Agent Skill、需要把规范和部署一次问全的开发者；接手他人技能、要做优化和调试的维护者；要在 OpenClaw / ClawHub 生态里发布技能的人。
需要注意的限制：
- 它是知识指南，不生成或修改你的技能代码，商业产品级技能仍需自行实现和评审。
- 各平台官方文档持续更新，指南内容以发布时的版本为准，遇到不一致以平台文档为准。
- 触发词覆盖面广，通用编程问题也会被相关词命中，这类请求应明确转回普通开发流程。
- 资料中标注的评分与下载数随时间变化，以 SkillHub 页面实时数据为准。
结尾¶
这个 Skill 的价值在于把分散在规范、部署文档和商店说明里的知识按技能生命周期组织起来，让开发者按同一顺序获取信息。仓库地址：https://api.skillhub.cn/user_148deca1/agentskills-complete-guide
