mcpField
C
create-plan

create-plan

github.com/davila7Agent 工作流33.0k543 次安装1 天前更新
代码仓库

关于 create-plan

将用户提示整理为一份可执行计划的技能,供编码 Agent 使用。它规定只读检查项目上下文、仅在必要时提问,并按范围和顺序组织行动清单。

主要功能

  1. 01只读检查项目上下文
  2. 02仅针对阻塞问题追问
  3. 03定义范围与非范围
  4. 04编排具体有序的行动清单
  5. 05规划测试、风险与待解决问题

适用场景

  1. 01在不改文件的情况下规划代码变更
  2. 02实施前查找相关文档与约束
  3. 03整理验证和发布步骤

安装

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

$npx skills add https://github.com/davila7/claude-code-templates --skill create-plan

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

详细介绍

创建计划

目标

将用户提示词转化为单一、可执行的计划,并在助手最终回复中给出。

最小工作流

在整个工作流中,保持只读模式。不要写入或更新文件。

  1. 快速扫描上下文

    • 阅读 README.md 以及任何明显的文档(docs/、CONTRIBUTING.md、ARCHITECTURE.md)。
    • 略读相关文件(最有可能被改动的文件)。
    • 识别约束(语言、框架、CI/测试命令、部署形态)。
  2. 仅在受阻时追问

    • 最多提 1–2 个问题。
    • 只有在没有答案就无法负责任地制定计划时才提问;优先使用选择题。
    • 如果不确定但未受阻,做出合理假设并继续。
  3. 使用下方模板创建计划

    • 以1 个简短段落开头,描述意图和方法。
    • 用简短表述明确指出范围内和范围外的内容。
    • 然后提供一个小型检查清单,列出行动项(默认 6–10 项)。
      • 每个检查清单项都应是具体行动,并在有帮助时提及文件/命令。
      • 让事项保持原子化且有序:发现 → 变更 → 测试 → 发布。
      • 动词优先:“添加…”、“重构…”、“验证…”、“发布…”。
    • 在适用时,至少包含一项用于测试/验证,以及一项用于边缘情况/风险。
    • 如果存在未知项,加入一个很小的开放问题部分(最多 3 个)。
  4. 不要在计划前添加元解释;仅按模板输出计划

计划模板(严格遵循)

# Plan

<1–3 sentences: what we're doing, why, and the high-level approach.>

## Scope
- In:
- Out:

## Action items
[ ] <Step 1>
[ ] <Step 2>
[ ] <Step 3>
[ ] <Step 4>
[ ] <Step 5>
[ ] <Step 6>

## Open questions
- <Question 1>
- <Question 2>
- <Question 3>

检查清单项指南

好的检查清单项:

  • 指向可能的文件/模块:src/...、app/...、services/...
  • 命名具体验证:“运行 npm test”、“为 X 添加单元测试”
  • 在相关时包含安全发布:功能开关、迁移计划、回滚说明

避免:

  • 模糊步骤(“处理后端”、“做认证”)
  • 过多微小步骤
  • 编写代码片段(让计划与实现无关)

评论

支持 Markdown