pi-yaml-hooks

为Pi和OMP智能体提供YAML钩子自动化管理

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pi-yaml-hooks。
它的用途是:为Pi和OMP智能体提供YAML钩子自动化管理
完整的 Skill 内容见:https://321skill.com/skills/pi-yaml-hooks/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请帮我删除 src/temp 目录”,配置了工具守卫钩子的智能体会先触发检查,询问“确认删除吗?此操作不可逆。” 得到确认后才会执行。或者,在每日站会时间,会话开始钩子会自动注入提示:“请先简要汇报昨日进展和今日计划。”

介绍

pi-yaml-hooks 旨在解决开发者在为 Pi 和 OMP 等智能体编程时,对工具调用、会话流程、提示词及系统通知等环节进行自动化管理和精细化控制的难题。它通过定义 YAML 格式的钩子(hooks),允许用户在特定事件(如工具调用前、会话开始后)触发自定义的守卫检查、提示词注入、通知发送或执行 Bash 脚本,从而实现工作流的自动化与定制化。

使用方式非常直接:开发者只需在项目中安装此 npm 包,并按照规范编写 YAML 配置文件。当智能体运行时,这些配置的钩子会被自动加载并执行。例如,可以配置一个工具守卫钩子,在调用“文件删除”工具前进行二次确认,或者配置一个会话钩子在每次对话开始时自动注入系统角色提示。

这个 Skill 非常适合那些深度使用 Pi 或 OMP 等编程智能体进行开发,并希望对其行为施加更精确控制、实现个性化自动化流程的中高级开发者或团队。它尤其适合需要将智能体集成到固定开发流水线或 CI/CD 环境中的场景。

在使用建议上,建议用户先从简单的通知或提示钩子开始,逐步尝试更复杂的守卫和 Bash 动作。由于钩子直接影响到智能体的行为逻辑,在部署到生产环境前,务必在测试环境中充分验证其逻辑,避免因守卫条件过于严格或脚本错误导致智能体核心功能被意外阻断。

核心特点

与同类通用自动化脚本或插件相比,pi-yaml-hooks 深度集成于 Pi/OMP 智能体的运行时内核,能直接在工具调用、会话生命周期等核心节点进行拦截和注入,提供了更底层、更即时的控制能力。其采用声明式的 YAML 配置,将复杂的自动化逻辑简化为清晰的规则定义,降低了实现高级控制功能的门槛。

注意事项

该 Skill 目前主要针对 Pi 和 OMP 智能体生态,不适用于 Claude Desktop、Cursor 等其他 AI 开发环境。

常见问题

pi-yaml-hooks 能用于 Claude 吗?

不能,它专为 Pi 和 OMP 智能体设计。

需要编程才能使用吗?

主要需要编写 YAML 配置文件,高级功能可能需搭配 Bash 脚本。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pi-yaml-hooks/raw/index.md 读取 pi-yaml-hooks 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。