mcpField
M
melech-plan-review

melech-plan-review

github.com/adirdAgent 工作流4541 次安装3 周前更新
代码仓库

关于 melech-plan-review

用于将方案呈现为可审阅的计划页面,而非深入讲解代码。它以类似 Git 差异的文件树展示变更、收集读者评论,并在收到批准、评论或拒绝意见后再继续。

主要功能

  1. 01类似 Git 的红绿文件树
  2. 02章节标记与简短变更说明
  3. 03生成 HTML 审阅页面
  4. 04收集页面内评论
  5. 05批准、评论或拒绝流程

适用场景

  1. 01向产品读者预览拟议变更
  2. 02在实施前收集反馈
  3. 03审阅仅存在于聊天中的计划

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/adird/agent-shell-hamelech --skill melech-plan-review

安装后在 Claude Code 中输入/melech-plan-review确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
template.html
evals/
evals.json
evals/fixtures/invoice-reminders/
invoice-reminders-plan-review.json
PLAN.md
evals/fixtures/invoice-reminders/apps/api/src/billing/
invoices.ts
scripts/
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