@kmalkenneth/pi-watch
监控代码中AI注释并转发给智能体
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@kmalkenneth/pi-watch。 它的用途是：监控代码中AI注释并转发给智能体 详细介绍见：https://321skill.com/skills/kmalkenneth-pi-watch/ 请根据该页面的说明完成安装。
使用示例
'启动 pi-watch 监控我的项目，当我在代码中写上“AI: 检查这段代码的内存泄漏风险”时，自动转发给安全审查智能体。' 它会开始监听文件变更，一旦检测到匹配的注释，立即将注释内容、文件路径和行号打包发送到预先配置的智能体端点，智能体随后返回分析结果。
介绍
在AI辅助编程日益普及的今天，开发者在代码中留下的AI注释（如“# AI优化建议”或“// TODO: 让AI重构”）往往需要手动收集和转发给智能体，流程繁琐且容易遗漏。pi-watch 是一个轻量级的 Pi 扩展，它能够实时监控你的代码文件，当检测到特定格式的AI注释时，自动将其内容发送到指定的智能体（Agent），实现从代码注释到智能体处理的自动化闭环。
使用方式非常简单：安装扩展后，只需在项目中运行 pi-watch 命令，它会自动监听当前工作目录下的代码变更。当你在代码中添加或修改以“AI:”等前缀开头的注释时，扩展会立即捕获，并通过预设的 API 接口将注释内容、文件名、行号等上下文信息推送给你的智能体。智能体可以据此执行代码审查、生成建议、自动修复等操作。
pi-watch 特别适合频繁使用 AI 辅助编程的开发者，尤其是那些需要将代码中的标注快速同步给自建智能体或 AI 工作流的团队。例如，你在代码中写下“AI: 检查这段代码的安全性”，pi-watch 就会自动将这段注释连同上下文发给安全审查智能体，让智能体及时响应。
需要注意的是，pi-watch 目前仅支持 Pi 扩展环境，且需要提前配置好智能体的接收端点（如 Webhook 或插件接口）。它不适用于无 AI 注释的普通代码监控场景，也不支持对非文本文件或二进制文件的监控。建议在项目初期就统一注释格式，以便扩展准确识别。
核心特点
与通用的代码监控工具不同，pi-watch 专为 AI 注释设计，能自动识别并提取注释中的指令，直接推送给智能体，而无需手动复制粘贴或配置复杂的 CI 流程。
注意事项
仅适用于 Pi 扩展环境，且需要智能体端有对应的接收接口，无法在无 AI 注释的普通代码库中发挥作用。
常见问题
如何安装 pi-watch？
通过 npm 安装：npm install @kmalkenneth/pi-watch，然后在 Pi 环境中启用扩展即可。
pi-watch 支持哪些注释格式？
默认支持以“AI:”开头的行注释或块注释，你也可以在配置文件中自定义前缀。