技能规则钩子分界工作流

技能规则钩子分界工作流

3个实用技能 · 3步完成 · 每一步都能单独使用

把智能体的“必须做到”和“需要理解后再做”分开：先分类规则，再审计钩子是否真的能拦截或询问，最后检查技能说明是否只承担上下文指导。套餐只处理脱敏 JSON，不接入 Claude Code、MCP、仓库或业务系统。

3个可下载技能 · 每个技能可单独运行

3步自动化工作流

🔵 1 技能规则责任分界

技能文件：rule-role-classifier

解决什么： 强制规则、上下文指导和不确定事项混在一份提示词里时，团队难以判断哪些要求必须由代码守住。

What you get: READY/REVIEW、每条规则的 HOOK/SKILL/SPLIT/REVIEW 角色、目标、理由和 classification_hash。

↓ 本步结果自动进入下一步

🟢 2 钩子强制执行审计

技能文件：hook-enforcement-auditor

解决什么： 规则虽然被标成强制，但钩子可能没有匹配器、超时、有效事件或阻断/询问策略，实际并不能构成门禁。

What you get: READY/BLOCKED、缺失钩子、事件、匹配器、超时和决策问题，以及 hook_audit_hash。

↓ 本步结果自动进入下一步

🟠 3 技能上下文指导审计

技能文件：skill-guidance-auditor

解决什么： 技能适合承载上下文、参考资料和判断步骤，却不应把“必然阻止”写成模型会永远遵守的承诺。

What you get: READY_FOR_HUMAN_REVIEW/BLOCKED、触发/输入/输出缺口、强制规则是否遗留在技能单独承担、human_decision=PENDING、execute=false、publish=false 和 guidance_audit_hash；这是最终交付。

实际示例

脱敏样例包含三条规则：阻止未审批写入、按项目上下文选择发布清单、记录工具调用证据。第一步把它们分别归为 HOOK、SKILL 和 HOOK；第二步核对 Write|Edit 的 PreToolUse 阻断钩子和 PostToolUse 记录钩子；第三步检查 release-guidance 的触发、输入输出和非强制承诺。该示例只验证离线结构，不代表真实钩子已注册或真实工具调用已被拦截。

适合谁

• 设计 Claude Code、MCP 或其他智能体技能与插件的开发者

• 需要把安全、审批、敏感写入和审计要求落实为明确边界的团队

• 维护多技能、多钩子项目并希望保留发布前核验材料的平台人员

• 需要给技能作者、评审人和安全负责人一份共同检查表的组织

买家只需提供

• 脱敏的规则列表，注明强制性、确定性和上下文依赖

• 钩子事件、匹配器、超时、失败策略和决策字段

• 技能 frontmatter、触发说明、输入输出和人工审核边界

使用方式

1. 使用 Python 3.10 或更高版本，将规则、钩子和技能说明写成 UTF-8 JSON。

2. 依次运行规则责任分界、钩子强制执行审计和技能上下文指导审计，也可以单独运行任一步。

3. 由有权限的负责人在自己的智能体工具中注册、测试或修改钩子与技能；本套餐只提供离线核验结果，不执行配置变更。

交付与验收

• 三个独立技能目录，每个包含元数据、技能说明、执行器、文档和脱敏样例。

• 三步可重复运行：规则分类、钩子合同审计、技能指导审计；每个技能也能单独使用。

• 强制规则无钩子、事件不支持、匹配器缺失、超时无效、失败策略不阻断、技能缺少触发/输入/输出或声称确定性执行，都会产生明确分支。

• 通过样例输出 READY 或 READY_FOR_HUMAN_REVIEW，并保留 PENDING 和不执行标志；错误样例输出 REVIEW/BLOCKED，不触碰真实智能体。

服务说明

脚本只处理买家有权使用且已经脱敏的本地 JSON，不连接 Claude Code、MCP、模型、仓库或业务系统，不读取 token、不注册钩子、不修改技能、不执行工具调用、不发布。离线核验不能代替目标运行时、权限层、版本兼容、工作区信任、人工审批和端到端测试。钩子是否真正生效必须由买家在自己的测试环境验证；套餐不承诺阻断成功、模型遵循率、成本下降或业务结果。