mcpField
P
prd-start

prd-start

github.com/vtmocanu开发3289 次安装1 天前更新
代码仓库

关于 prd-start

prd-start 是用于启动 PRD 实施的工作流技能。它检查就绪情况与范围，分配关联议题、设置分支和开发环境，然后交接后续工作，不负责选择任务或开始实现。

主要功能

  1. 01确定目标 PRD
  2. 02检查就绪情况与范围
  3. 03分配关联议题
  4. 04创建或确认功能分支
  5. 05准备环境并交接工作

适用场景

  1. 01开始实施指定的 PRD
  2. 02在开发前检查 PRD
  3. 03在任务规划前设置开发环境

安装

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

$npx skills add https://github.com/vtmocanu/skills --skill prd-start

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

详细介绍

移植自 vfarcic/dot-ai shared-prompts/prd-start.md（MIT，Copyright (c) 2025 Viktor Farcic）。原作者：Viktor Farcic。

PRD Start - 开始实施工作

说明

你将协助启动针对特定产品需求文档（PRD）的实际实施工作。此命令会设置实施上下文（验证准备情况、创建分支、准备环境），然后交由 /prd-next 确定任务。

与 Forge 无关：以下 gh 命令是 GitHub 示例。请通过 git remote get-url origin 检测所用的 Forge，并使用相应的 CLI，将每个动词映射为等效命令：GitHub → gh；GitLab → glab（PR 称为合并请求，使用 glab mr …）；Forgejo/Gitea → tea。如果缺少所需的 CLI，请告知用户并提供其安装页面链接。

重要：回复中不得包含时间或工作量估算。请专注于准备工作和就绪情况，不要猜测所需时长。

流程概览

  1. 选择目标 PRD - 确定要实施的 PRD
  2. 验证 PRD 是否就绪 - 确保 PRD 已准备好实施
  3. 设置实施上下文 - 创建分支并准备环境
  4. 交接给 prd-next - 将任务确定工作委托给相应的提示词

步骤 0：检查 PRD 参数

如果提供了 PRD 编号参数（$ARGUMENTS）：

  • 跳过上下文检查和自动检测
  • 直接使用 PRD #$ARGUMENTS
  • 继续执行步骤 2（PRD 就绪情况验证）

如果未提供 prdNumber 参数：

  • 继续执行下方的上下文感知检查

步骤 0b：上下文感知检查

检查近期对话中的 PRD 上下文是否已经明确：

如果近期对话中出现以下内容，则跳过检测：

  • 讨论了近期的 PRD 工作 - “我们刚完成 PRD 29 的工作”、“刚完成 PRD 更新”等
  • 提到了特定 PRD - “PRD #X”、“MCP Prompts PRD”等
  • 使用了 PRD 专属命令 - 近期使用过 /prd-update-progress，或针对特定 PRD 使用过 /prd-start
  • 工作上下文明确 - 讨论了已知 PRD 的特定功能、任务或需求

如果上下文明确：

  • 使用已知的 PRD，跳转至步骤 2（PRD 就绪情况验证）

如果上下文不明确：

  • 继续执行步骤 1（检测 PRD）

步骤 1：智能检测 PRD（仅在上下文不明确时执行）

根据以下上下文线索自动检测目标 PRD（按优先级排序）：

  1. Git 分支分析 - 检查当前分支名称中的 PRD 模式：

    • feature/prd-12-* → PRD 12
    • prd-13-* → PRD 13
    • feature/prd-* → 提取 PRD 编号

  2. 近期 Git 提交 - 查看近期提交消息中的 PRD 引用：

    • “fix: PRD 12 documentation” → PRD 12
    • “feat: implement prd-13 features” → PRD 13

  3. Git 状态分析 - 检查已修改或暂存的文件，寻找 PRD 线索：

    • 已修改 prds/12-*.md → PRD 12
    • 特定功能目录中的变更

  4. 发现可用 PRD - 列出 prds/ 目录中的所有 PRD

  5. 回退到由用户选择 - 仅当上下文检测失败时，询问用户要指定哪个 PRD

检测逻辑：

  • 高置信度：分支名称与 PRD 模式匹配（例如，feature/prd-12-documentation-testing）
  • 中置信度：Git 状态中有已修改的 PRD 文件，或近期提交提及 PRD
  • 低置信度：有多个可用的 PRD，使用启发式规则（最新、最大）
  • 无上下文：向用户展示可用选项

如果上下文检测失败，请询问用户：

## Which PRD would you like to start implementing?

Please provide the PRD number (e.g., "12", "PRD 12", or "36").

**Not sure which PRD to work on?**
Run `/prds-get` to see all available PRDs organized by priority and readiness.

**Your choice**: [Wait for user input]

确定 PRD 后：

  • 从 prds/[issue-id]-[feature-name].md 读取 PRD 文件

步骤 2：PRD 就绪情况验证

开始实施前，验证 PRD 是否已准备就绪：

需求验证
  • 功能需求：核心需求是否定义清晰且完整？
  • 成功标准：是否设定了可衡量的成功标准？
  • 依赖项：是否已识别所有外部依赖项，且这些依赖项是否可用？
  • 风险评估：是否已识别主要风险并制定缓解计划？
文档分析

对于文档优先的 PRD：

  • 规范完整性：是否已通过用户工作流完整记录该功能？
  • 集成点：是否已记录与现有功能的连接？
  • API/接口定义：是否已指定所有接口和数据结构？
  • 示例和用法：是否提供了具体的用法示例？
实施就绪检查清单
## PRD Readiness Check
- [ ] All functional requirements defined
- [ ] Success criteria measurable
- [ ] Dependencies available
- [ ] Documentation complete
- [ ] Integration points clear
- [ ] Implementation approach decided

**如果 PRD 尚未就绪：**告知用户缺少哪些内容，并建议先完成 PRD 规划。

范围检查（每个 PRD 均须在实施或派发前执行）

按照 /prd-create 的范围门槛（步骤 1.2）检查 PRD 当前内容：

  • 硬性停止：某个里程碑需要尚未完成的 PRD。指出该里程碑，并建议将其移至该 PRD 或重新划定范围边界；不要开始工作。
  • 范围审查警报：包含多个可独立体现价值的成果，或预计会产生较大的 PR。提出具体的拆分方案（子成果、顺序和阻塞项），并将其作为一个是/否问题提出。如果你认为拆分无法产生可独立体现价值的部分（例如必须完整交付、紧密耦合的安全工作），请说明理由，在 PRD 的 Decision Log 中记录，然后继续。在 /prd-full 下，提出拆分方案是唯一不受其不暂停规则约束的情况：停止并输出拆分方案，不要实施。
  • 里程碑中的现场验收复选框：建议将其移至关联的 acceptance issue，以便完成情况仅统计实施工作。

步骤 3：设置实施上下文

⚠️ 必须：在继续步骤 4 之前完成此步骤

Issue 指派

将 GitHub issue 指派给自己，以表明工作正在进行：

gh issue edit [issue-id] --add-assignee @me

这样可以防止其他人领取同一个 PRD 并行开展工作。

Git 分支管理
  1. 检查当前分支：运行 git branch --show-current
  2. 如果处于 main 或 master 分支：创建并切换到功能分支： 
    git checkout -b feature/prd-[issue-id]-[feature-name]
  3. 如果已处于功能分支：确认该分支是否适用于此 PRD
开发环境设置
  • 依赖项：安装 PRD 所需的任何新依赖项
  • 配置：设置开发所需的任何配置
  • 测试数据：准备测试数据或模拟服务
步骤 3 检查点（必需）

继续步骤 4 之前，你必须显示以下确认信息：

## Environment Setup ✅
- **Assignee**: @[username] ✅
- **Branch**: `[current-branch-name]` ✅
- **Status**: [Created new branch / Already on correct branch / Staying on main (reason)]

在确认分支设置之前，不要继续步骤 4。

步骤 4：移交给 prd-next

实施上下文设置完成后，向用户显示以下消息：

## Ready for Implementation 🚀

**PRD**: [PRD Name] (#[PRD Number])
**Assignee**: @[username]
**Branch**: `[branch-name]`
**Status**: Ready for development

---

To identify and start working on your first task, run `/prd-next`.

⚠️ 到此为止——不要：

  • 识别或推荐要处理的任务
  • 分析实施优先级或关键路径
  • 开始任何实施工作
  • 在显示移交消息后继续执行

/prd-next 负责识别所有任务并提供实施指导。

成功标准

此命令应当：

  • ✅ 成功识别要实施的目标 PRD
  • ✅ 验证 PRD 已准备好开展开发工作
  • ✅ 将 GitHub issue 指派给当前用户，以避免重复工作
  • ✅ 设置适当的实施上下文（分支、环境）
  • ✅ 移交给 /prd-next 识别任务
  • ✅ 衔接 PRD 规划与开发环境设置

备注

  • 此命令仅专注于设置——它会验证就绪情况、创建分支并准备环境
  • 设置完成后，/prd-next 负责识别所有任务、提供实施指导并跟踪进度

评论

支持 Markdown