关于 plan-self-review
plan-self-review 是一项用于在计划创建或更新后进行检查的 Agent 技能。它从清晰度、完整性、可行性和一致性评分,并列出缺口、指导改进。
主要功能
- 01四项计划评分
- 02按优先级列出缺陷
- 03改进计划并最终检查
- 04结构化评审格式
适用场景
- 01检查新拟定的实施计划
- 02执行前复核更新后的计划
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ hrdtbs/ agent-skills --skill plan-self-review安装后在 Claude Code 中输入/plan-self-review确认已加载。
详细介绍
计划自审
创建或更新计划后,立即使用此技能。及早发现逻辑漏洞、步骤含糊不清或缺少依赖项,可避免执行过程中出现连锁故障。自审计划有助于你系统地处理问题,并降低日后需要大幅修改的可能性。
审查步骤
- 为计划打分(满分 100 分):根据以下标准评估计划:
- 清晰度(25 分):步骤是否清晰且易于执行?是否说明了将使用哪些文件和工具?
- 全面性(25 分):计划是否涵盖任务的所有必要方面?是否遗漏了任何边缘情况?
- 可行性(25 分):使用现有工具和上下文能否完成这些步骤?是否有足够的信息来执行?
- 一致性(25 分):是否存在逻辑矛盾或遗漏?步骤顺序是否合乎逻辑?
- 列出缺陷:针对计划中的任何漏洞、遗漏或歧义,创建一个按优先级排列的任务列表(
- [ ])。 - 改进:编辑计划以解决已发现的缺陷。使用适当的工具更新计划。
- 最终检查:进行最终检查,确认不存在逻辑矛盾或遗漏。
输出格式
按以下结构呈现审查结果:
自评得分:[得分]/100
- 清晰度:[得分]/25
- 全面性:[得分]/25
- 可行性:[得分]/25
- 一致性:[得分]/25
缺陷
- [缺陷 1]
- [缺陷 2]
已做的改进
- [简要说明对计划所做的改进]
最终检查
- [确认计划现在逻辑严谨且完整]
示例
示例 1:审查添加新 API 端点的计划
初始计划:
- 创建新端点。
- 更新测试。
自审结果:
自评得分:40/100
- 清晰度:10/25(未说明要编辑的文件以及端点的功能)
- 全面性:10/25(未说明文档更新和错误处理细节)
- 可行性:10/25(过于笼统,无法在没有进一步说明的情况下执行)
- 一致性:10/25(逻辑上合理,但缺少具体步骤)
缺陷
- 指定新端点所在的确切文件和路由
- 补充错误处理要求
- 确定需要更新的测试文件,并说明要添加哪些测试用例
- 添加更新 API 文档的步骤
已做的改进
- 更新计划,指定目标文件(
src/api/users.js)和路由(POST /users)。 - 添加子步骤,实现输入验证和错误处理。
- 指定测试文件(
tests/api/users.test.js),并明确要求测试错误情况。 - 添加更新
docs/api.md的步骤。
最终检查
- 修订后的计划清晰、全面,并明确指定了文件和操作。逻辑严谨,可以开始执行。
评论
支持 Markdown