关于 melech-plan-review
用于将方案呈现为可审阅的计划页面,而非深入讲解代码。它以类似 Git 差异的文件树展示变更、收集读者评论,并在收到批准、评论或拒绝意见后再继续。
主要功能
- 01类似 Git 的红绿文件树
- 02章节标记与简短变更说明
- 03生成 HTML 审阅页面
- 04收集页面内评论
- 05批准、评论或拒绝流程
适用场景
- 01向产品读者预览拟议变更
- 02在实施前收集反馈
- 03审阅仅存在于聊天中的计划
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ adird/ agent-shell-hamelech --skill melech-plan-review安装后在 Claude Code 中输入/melech-plan-review确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdtemplate.htmlevals/evals.jsonevals/fixtures/invoice-reminders/invoice-reminders-plan-review.jsonPLAN.mdevals/fixtures/invoice-reminders/apps/api/src/billing/invoices.tsscripts/review_server.py详细介绍
计划评审
在他们批准之前,先让他们预览这个方案。用类似 Git 的红绿行文件树展示会有哪些变化,以及他们可以期待什么,就像 PR 已准备就绪,他们正在查看变更选项卡一样。
页面面向他们或产品读者。他们并不打算深入了解代码。
用蓝色的 @@ section @@ 行标记文件的每个部分。像 diff 一样缩进。行为是重点时,就写一句话。用简短的代码行比句子更容易读懂时,就写代码行。不要粘贴周边的实现代码。
打开以供评审
将 template.html 复制到计划文件旁边的 <plan-name>-plan-review.html;如果计划只在聊天中,则复制到仓库根目录。填写每个 {{TOKEN}}。
使用此文件旁边的 scripts/review_server.py 在后台提供页面:
python3 <skill-dir>/scripts/review_server.py <plan-name>-plan-review.html
它会打开页面,并打印 URL 和评审文件路径。读者发表评论时,评论会保存到页面旁边的 <plan-name>-plan-review.json。
等待评审结果
提出一个包含三个选项的问题:批准、已评论、拒绝。如果你有提问工具,就使用它。否则在聊天中提问,并结束本轮。
他们回答后,读取评审文件。文件包含总体 summary 和 comments。每条评论都包含 body,以及它指向的位置:file、lines 和他们选中的 quote。一条评论可以指向多行,也可以指向多个文件中的位置。file 为 null 时,表示页面页眉。
- 批准:计划通过。纳入所有评论,然后停止服务。除非他们要求,否则不要开始实施。
- 已评论:在聊天中逐条回复评论,按评论要求修改计划,并重写页面。将评审文件重命名为
<plan-name>-plan-review-<round>.json,请他们刷新选项卡,然后再次提问。 - 拒绝:阅读评论,了解拒绝原因。如果没有评论,就询问哪里有问题。在方向明确之前,不要重写页面。停止服务。
评论
支持 Markdown