Loading...
Loading...
面向AI编码Agent的交互式计划与差异审查工具。通过可视化浏览器UI为Agent计划添加注释——以结构化反馈批准或请求修改。支持代码审查、图像注释,并可自动保存至Obsidian/Bear Notes。
npx skill4agent add supercent-io/skills-template plannotator关键词:| 来源: https://github.com/backnotprop/plannotatorplanno以可视化方式为AI编码Agent的计划添加注释并进行审查,与团队共享,一键发送反馈。 兼容Claude Code和OpenCode。
scripts/| 脚本 | 模式 | 用法 |
|---|---|---|
| CLI安装 | 一键安装plannotator CLI |
| 钩子设置 | 配置Claude Code的ExitPlanMode钩子 |
| 状态检查 | 验证完整的安装与配置情况 |
| 远程模式 | SSH / devcontainer / WSL配置 |
| 代码审查 | 启动差异审查UI |
# 仅安装CLI(macOS / Linux / WSL)
bash scripts/install.sh
# 安装CLI并获取Claude Code插件命令
bash scripts/install.sh --with-pluginhttps://plannotator.ai/install.sh# 将钩子添加至~/.claude/settings.json
bash scripts/setup-hook.sh
# 预览将进行的更改(不实际写入)
bash scripts/setup-hook.sh --dry-runExitPlanMode~/.claude/settings.json/plugin marketplace add backnotprop/plannotator
/plugin install plannotator@plannotator
# 重要:安装插件后请重启Claude Code当Claude Code退出计划模式时,将通过钩子自动触发。
Shift+Tab×2deleteinsertreplacecomment# 审查所有未提交的更改
bash scripts/review.sh
# 审查特定提交
bash scripts/review.sh HEAD~1
# 审查分支差异
bash scripts/review.sh main...HEADplannotator review# 交互式设置(SSH, devcontainer, WSL)
bash scripts/configure-remote.sh
# 查看当前配置
bash scripts/configure-remote.sh --show
# 直接设置端口
bash scripts/configure-remote.sh --port 9999.zshrc.bashrc.profilePLANNOTATOR_REMOTE=1PLANNOTATOR_PORTexport PLANNOTATOR_REMOTE=1 # 不自动打开浏览器
export PLANNOTATOR_PORT=9999 # 用于转发的固定端口| 变量 | 说明 |
|---|---|
| 远程模式(不自动打开浏览器) |
| 本地/转发的固定端口 |
| 自定义浏览器路径/应用 |
| 自定义共享门户URL |
bash scripts/check-status.sh~/.claude/settings.json1. bash scripts/install.sh --with-plugin
└─ 安装CLI + 显示插件安装命令
2. bash scripts/setup-hook.sh ← 使用插件时可跳过此步骤
└─ 配置自动计划审查触发器
3. bash scripts/check-status.sh
└─ 确认所有配置已就绪
4. [在计划模式下与Agent协作编码]
└─ 按Shift+Tab×2时,plannotator将自动打开
5. bash scripts/review.sh ← Agent完成编码后运行
└─ 打开可视化差异审查UIopencode.json{
"plugin": ["@plannotator/opencode@latest"]
}