Build Claude Code Skills（DojoCodingLabs）— 触发器、钩子与记忆护栏开发指南

技能简介

Build Claude Code Skills 是 DojoCodingLabs 开源的 Claude Code 技能开发完整指南，重点解决"技能激活规则脆弱、钩子配置混乱、护栏行为不可预测"三大痛点。它系统讲解 SKILL.md 的结构写法、四类激活触发模式（关键词 / 意图 / 文件路径 / 内容匹配）、UserPromptSubmit 与 PreToolUse 等钩子生命周期，以及带记忆的护栏技能设计方法，并配套本地测试命令与故障排查参考。该技能经 Skillstore 完整审计、风险等级 safe，是目前平台上视图量最高的技能开发类指南之一。

核心能力

• SKILL.md 结构规范：讲解 frontmatter 与激活语言的写法，让技能文件从第一行就符合加载要求。
• 四类触发模式：覆盖关键词、意图、文件路径、内容匹配四种激活方式，附带降低误触发的调优方法。
• 钩子生命周期文档：说明 UserPromptSubmit、PreToolUse、Stop 等钩子的执行时机与典型工作流。
• 本地测试命令：提供验证触发行为和钩子执行的具体命令，发布前即可在本地确认行为正确。
• 记忆型技能模式：讲解会话跟踪、跳过条件、用户控制开关等记忆感知设计，支持跨会话保留已批准计划。
• 故障排查参考：链接到规则 Schema、触发排错、进阶模式等详细参考文档，定位"技能不触发"类问题。

安装配置

• Skillstore CLI 安装：运行 npx skillstore add dojocodinglabs/skill-developer 获取已审计版本。
• 仓库手动安装：从 GitHub 仓库 DojoCodingLabs/claude-code-waypoint 的 .claude/skills/skill-developer 目录复制到本地技能路径。
• 环境要求：示例基于 Claude Code 标准项目布局（.claude 目录）与 TypeScript 钩子，其他环境需自行适配命令。
• 加载确认：安装后确认目标 Agent 的技能目录已被识别，钩子代码需按仓库文档单独启用。

使用步骤

1. 起草技能文件：按指南编写 SKILL.md，包含 frontmatter、激活描述与核心指令，并保持主体简洁。
2. 设计激活规则：根据真实用户请求选择关键词 / 意图 / 路径 / 内容触发的组合，写入规则配置。
3. 接入钩子：如需护栏或状态联动，按 UserPromptSubmit、PreToolUse、Stop 的时机挂载对应钩子逻辑。
4. 本地测试触发：用指南附带的测试命令配合真实提示词和真实文件路径验证激活是否符合预期。
5. 调优误触发：对照排错参考修正过宽关键词、缺失排除项等问题，必要时补充 skip 条件。
6. 文档化护栏：记录护栏的执行级别（建议 / 警告 / 阻断）、记忆存储位置与用户的查看清除方式。

适用场景

• 新建团队技能：为团队工作流起草第一个带标准激活规则的 SKILL.md。
• 技能激活调优：技能存在但误触发或不触发时，系统性排查触发四要素。
• 护栏技能落地：为高风险操作（破坏性命令、敏感文件）设计建议-警告-阻断三级护栏。
• 跨会话记忆设计：需要技能在多轮会话中记住已批准计划并提供用户控制开关。
• 技能发布前体检：用测试命令和参考清单做最后一轮触发与钩子验证。

适用人群

• Claude Code 重度用户：希望自定义技能与钩子行为的个人开发者。
• 团队平台工程师：负责统一团队 Agent 配置与护栏标准的维护者。
• 安全与合规角色：需要为 AI 编码流程设计强制护栏的团队。
• 技能库管理员：维护大量技能、需要排查激活问题的负责人。

工作原理

技能的核心是把"激活"和"执行"分离成两层：激活层靠四类触发模式决定技能何时被唤起，执行层靠钩子生命周期决定在关键节点（提示提交前、工具调用前、响应停止时）注入什么行为。记忆层则在两者之上引入会话状态——技能可以记录已批准的计划、跳过条件与用户开关，使护栏行为跨会话保持一致。指南同时强调用本地测试命令把触发行为验证前置，避免"上线后才发现技能不触发"。需要说明它是纯文档型技能，不自动安装钩子代码，也不替代对钩子安全影响的人工评审。

官方链接

• Skillstore 页面：https://skillstore.io/skills/dojocodinglabs-skill-developer
• GitHub 仓库：https://github.com/DojoCodingLabs/claude-code-waypoint/tree/main/.claude/skills/skill-developer
• Manifest：https://skillstore.io/api/skills/dojocodinglabs-skill-developer/manifest
• 安装命令：npx skillstore add dojocodinglabs/skill-developer