关于 plan-builder
plan-builder 是用于编写实现计划的技能,会根据任务复杂度选择模板,适用于从小型修复到大型架构变更的开发工作。
主要功能
- 01按复杂度选择模板
- 02支持精简、标准和全面计划
- 03记录研究结果与参考资料
- 04每份计划列出验收标准
- 05按需添加 UI 和 DevOps 章节
适用场景
- 01规划局部缺陷修复
- 02筹备涉及多个组件的功能
- 03梳理分阶段架构变更
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ majesticlabs-dev/ majestic-marketplace --skill plan-builder安装后在 Claude Code 中输入/plan-builder确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/comprehensive.mdminimal.mdstandard.md详细介绍
计划构建器
根据复杂度使用合适的模板编写实施计划。
模板选择
| 复杂度 | 使用场景 | 模板 |
|---|---|---|
| 最简 | 简单的错误、小幅改进、明确的单文件变更 | references/minimal.md |
| 标准 | 大多数功能、复杂错误、团队协作 | references/standard.md |
| 全面 | 重大功能、架构变更、多阶段工作 | references/comprehensive.md |
选择标准
适用于最简模板的情况
- 修复方案明显且范围有限
- 涉及单个文件或 2-3 个相关文件
- 无需做出架构决策
- 描述中有明确的验收标准
适用于标准模板的情况(默认)
- 影响多个组件
- 需要调研或查阅外部文档
- 团队评审需要了解背景
- 存在依赖项或风险
适用于全面模板的情况
- 新系统或重大功能
- 工作分为多个阶段
- 需要做出架构决策
- 涉及跨领域问题(安全、性能)
- 涉及多个团队或利益相关方
计划输出
将计划写入:docs/plans/[YYYYMMDDHHMMSS]_<title>.md
每份计划都必须包含:
- 调研发现及文件路径(例如,
src/models/user.rb:42) - 外部文档 URL
- 相关议题/PR(如已知)
- 验收标准(来自用户输入,取自蓝图步骤 2)
条件章节
UI 功能
当功能涉及以下内容时,加入“设计系统参考”章节:
- 页面、组件、表单、按钮、模态框
- 视觉设计元素
DevOps 功能
当功能涉及以下内容时,加入“基础设施背景”章节:
- Terraform/OpenTofu、Ansible、云资源
- Docker、CI/CD、基础设施
反模式
| 不要 | 应该 |
|---|---|
| 对简单错误使用全面模板 | 根据实际复杂度选择模板 |
| 跳过验收标准 | 始终包含可测试的标准 |
| 保留占位文本 | 填写所有章节或将其删除 |
| 对明显的变更过度规划 | 提供最简模板自有其原因 |
评论
支持 Markdown