@khimaros/pi-evolve

为 pi-coding-agent 提供自修改钩子扩展,实现 hook 协议。

安装使用

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

帮我安装这个 AI Skill:@khimaros/pi-evolve。
它的用途是:为 pi-coding-agent 提供自修改钩子扩展,实现 hook 协议。
完整的 Skill 内容见:https://321skill.com/skills/khimaros-pi-evolve/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

“使用重构钩子优化这段代码。”,它会先调用你配置的 opencode-evolve 重构前钩子进行分析,然后执行代码优化,最后再触发重构后钩子进行格式化或检查。整个过程无需你手动切换工具或调整钩子脚本。

介绍

该 Skill 旨在解决 pi-coding-agent 与 opencode-evolve 生态中钩子(hook)的兼容性问题。opencode-evolve 项目定义了一套钩子协议,允许开发者在代码生成或修改过程中插入自定义逻辑,但原生的 pi-coding-agent 并不直接支持这套协议。本 Skill 通过实现该协议,使原本为 opencode-evolve 设计的钩子能够无缝地在 pi-coding-agent 中运行,无需修改钩子代码。

使用方式非常简单。安装本 Skill 后,pi-coding-agent 便具备了识别和执行 opencode-evolve 钩子的能力。当你在 pi-coding-agent 中执行代码生成或重构任务时,如果配置了相应的钩子,这些钩子会被自动触发并执行其预设的逻辑,例如代码风格检查、自动格式化或安全扫描等。

它非常适合那些已经在 opencode-evolve 生态中投入了开发,编写了大量自定义钩子,但希望或需要迁移到 pi-coding-agent 进行编码辅助的开发者或团队。这避免了重复开发,保护了既有投资。

使用建议是,确保你的钩子脚本遵循 opencode-evolve 的钩子协议规范。注意事项在于,由于运行环境从 opencode-evolve 切换到了 pi-coding-agent,需要测试钩子在新的上下文和 API 环境中是否完全按预期工作,特别是涉及文件系统操作或外部工具调用的部分。

核心特点

核心区别在于,它并非创建一套新的钩子系统,而是充当了一个“协议适配器”,专门让为 opencode-evolve 设计的现有钩子能在 pi-coding-agent 中原封不动地运行,实现了生态间的无缝迁移。

注意事项

如果你没有使用 opencode-evolve 钩子的需求,或者你的钩子严重依赖 opencode-evolve 特有的运行时环境,此 Skill 可能不适用。

常见问题

这个 skill 能自己写钩子吗?

不能,它是运行现有 opencode-evolve 钩子的适配器。

安装后如何配置我的钩子?

钩子配置方式与在 opencode-evolve 中相同,本 skill 会自动识别并执行。

给 AI 助手的安装指引

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

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