智能体技能全栈指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_148deca1/agentskills-complete-guide。
技能介绍
要解决什么问题
做 Agent Skills 时,常见卡点不是「不会写 Markdown」,而是三条线各缺一环:概念不清容易把技能写成泛泛的提示词;不跟 Anthropic 规范会导致触发不稳、护栏与领域技能混用;只会在 Claude Code 里试却在 OpenClaw、扣子、Trae 等环境里配不通、沙箱里环境变量继承不到。资料又分散在生态说明、官方实践和部署文档里,很难按你当前阶段(了解概念 / 编写 / 部署 / 调试)一次问对地方。
技能如何工作
本技能把内容收成三大模块,并在对话开头用清单确认阶段、目标平台和问题类型,再路由到对应知识:
- Skills 概念与生态:Agent Skills 解决什么问题、与 MCP 的分工、简洁至上 / 自由度光谱、
SKILL.md四要素(name、description、正文、安全边界)与渐进式披露 - Anthropic 开发规范:护栏(
BLOCK)与领域(SUGGEST)技能、触发器(关键词、意图正则、路径 glob、内容模式)、UserPromptSubmit与PreToolUseHook 及跳过条件 - OpenClaw 部署架构:
openclaw.json中skills.entries启用与环境注入、沙箱 Docker 内env配置、ClawHub 搜索安装发布、多渠道集成
交付时按 需求识别 → 知识检索 → 结构化回答 → 质量检查 走一遍,并附带常见场景话术(例如技能不触发、正文超 500 行拆 references/、配置下一轮交互才生效)。
适用边界与注意点
适合 Skills 概念咨询、SKILL.md 规范审查、Anthropic 实践(触发器 / Hook / 执行级别)以及 OpenClaw / ClawHub 配置与排错。不替代各平台完整官方文档,也不覆盖与技能无关的通用编程或专业领域(法律、医疗等)判断。平台差异大时,需要先明确你用的是 Claude Code、OpenClaw 还是其他宿主,否则部署路径会对不上。
使用场景
- 在 Claude Code 仓库里从零起草合同审查类技能,需要按四要素写出可触发的 `SKILL.md` 与护栏边界说明
- 技能已放进 `.claude/skills/` 但用户换句式提问仍不激活,要对照 description、目录路径和 skip 条件逐项排查
- OpenClaw 沙箱 Docker 内技能进程拿不到宿主机 `process.env`,要为单智能体配置 `sandbox.docker.env` 注入密钥
- 主技能 `SKILL.md` 超过 500 行影响加载,要把详细资料拆进 `references/` 并改写主文件引用结构
适合人员
- 维护 OpenClaw 接 Telegram/WhatsApp 的后端工程师,要把 ClawHub 技能写入 `skills.entries` 并验证监听生效
- 推动团队统一 Agent Skills 规范的技术负责人,要区分护栏 `BLOCK` 与领域 `SUGGEST` 及对应 Hook 用法
- 从扣子或 Trae 迁到 OpenClaw 的智能体开发者,遇到配置改完却要等下一轮对话才生效的部署困惑
- 负责交付垂直流程技能(如审查、发布检查)的产品工程师,需要可评审的标准 `SKILL.md` 与触发器设计