Planning Draft

产品规划草稿生成技能 (Planning Draft Skill)

概述

本技能基于 gather-product-context 输出的产品上下文快照 + 用户规划意图，生成符合 DESIGN-DOC 规范（docs/product-planning/ 目录）的产品规划文档草稿。

本技能仅输出草稿到对话上下文，不写入任何文件。 落盘操作由调用方（product-planning-agent）在用户确认后通过 engineering-docs 执行。

---

输入参数

| 参数 | 必填 | 类型 | 说明 | |------|------|------|------| | context | 是 | string | gather-product-context 输出的产品上下文快照（Markdown 格式） | | intent | 是 | string | 用户的规划意图（如"规划 v0.16 版本功能集"、"做 2026-Q3 季度规划"） | | scope | 否 | string | 规划范围：version（单版本）/ quarter（季度）/ annual（年度）/ feature-focus（功能专项）；默认从 intent 推断 | | focus-features | 否 | array | 手动指定重点关注的 feature ID 列表（如 ["ai-assistant", "delivery-pipeline"]） | | exclude-features | 否 | array | 明确排除的 feature ID 列表 |

---

执行流程

步骤 1 — 意图解析与信息完整性检查

必填字段验证：

• [ ] context 不为空（产品快照已提供）
• [ ] intent 不为空（规划意图明确）
• [ ] 规划范围可确定（从 scope 参数或 intent 中推断）

如信息不足，停止执行并追问（每轮 ≤ 2 个问题）：

❓ 我需要补充以下信息才能生成规划文档：
1. {缺失问题 1}
2. {缺失问题 2}（如有）

步骤 2 — 规划内容分析

基于产品上下文快照，进行以下分析：

2a. 现状扫描

• 当前焦点版本的完成度与剩余任务
• 已规划版本（planned）的功能覆盖情况
• 识别未被任何版本规划覆盖的 backlog 特性
• 识别想法池中有价值的需求（尚未进入 spec 流程）

2b. 竞品与市场信号整合

• 从竞品分析中提取差异化机会点
• 从市场洞察中提取用户需求信号
• 标注高置信度信号（多个来源交叉验证）与低置信度信号（单一来源）

2c. CR 影响评估

• 梳理活跃 CR 对已有 spec 的变更影响
• 判断是否影响本次规划的功能范围

2d. 优先级推断

• 结合 priority（P0/P1/P2）、target-version、stage 综合排序
• 对 focus-features 参数指定的特性给予更高权重
• 对 exclude-features 参数指定的特性标记为排除

2e. 版本主题提炼

• 根据功能集的共同特征提炼版本主题（如"AI 深化 + 效率工具"）

步骤 3 — 文档草稿生成

按照输出格式规范，生成完整的产品规划文档草稿。

步骤 4 — 输出与提示

输出草稿后，必须附上以下提示：

---
> 以上为产品规划草稿，尚未写入任何文件。
> 请审阅内容，如需修改请直接告诉我具体调整的地方。
> 确认满意后，我将落盘到 `docs/product-planning/`。

---

输出文档格式（DESIGN-DOC 规范）

---
id: 
type: DESIGN-DOC
name: {scope}-planning-{YYYY-QN 或 vX.Y}
title: {规划标题}
doc-role: DESIGN-DOC
status: draft
owner: {当前用户，未知时填 tbd}
created: {今日 YYYY-MM-DD}
updated: {今日 YYYY-MM-DD}
refs:
  features: [{关联的 spec feature ID 列表}]
  versions: [{关联的版本号列表}]
---

# {规划标题}

> DESIGN-DOC（产品规划）· 草稿  
> 规划范围：{scope 描述}  
> 基于数据快照：{快照生成时间}

---

## 1. 规划背景与目标

### 1.1 背景

{说明本次规划的背景：当前产品阶段、触发规划的关键事件或周期节点}

### 1.2 规划目标

{本次规划要达成的核心目标，2-4 条，可量化优先}

### 1.3 规划范围说明

- **覆盖范围**：{版本区间 / 时间范围 / 功能域}
- **不在本次规划范围**：{明确排除项}

---

## 2. 现状分析

### 2.1 Baseline 与在途 CR 概览

| 类型 | 对象 | 状态 | 优先级 | 目标版本 | 负责人 |
|-------|------|-------|---------|-------|
| baseline | {spec name} | ga | P0 | vX.Y | - |
| CR | {CR title} | developing | P1 | vX.Y | ... |

**关键观察**：{2-3 条基于 baseline 与在途 CR 的观察结论}

### 2.2 变更请求（CR）影响

{列出活跃 CR 及其对本次规划的影响}

{如无活跃 CR → "当前无活跃变更请求，对本次规划无影响。"}

### 2.3 想法池输入

{梳理需求想法池中值得纳入规划的条目及理由}

{如无想法 → "想法池当前为空。"}

### 2.4 竞品与市场信号

**竞品信号：**
- {竞品名称}：{对本产品规划的启示，1-2 句}

**市场信号：**
- {洞察标题}：{对本产品规划的启示，1-2 句}

**综合判断**：{基于竞品和市场信号，当前产品的差异化机会点}

---

## 3. 版本规划

### 3.1 目标版本与主题

| 版本 | 主题 | 目标时间 | 状态 |
|------|------|---------|------|
| vX.Y | {主题} | {YYYY-QN} | planned |

### 3.2 功能优先级排序

**P0 — 必须做（核心体验 / 阻断性问题）**

| 功能 | 来源 | 理由 |
|------|------|------|
| {feature-id}（{title}）| backlog / idea / CR | {纳入理由} |

**P1 — 重要（用户价值高 / 有明确需求信号）**

| 功能 | 来源 | 理由 |
|------|------|------|
| ... | ... | ... |

**P2 — 可选（加分项 / 依赖资源）**

| 功能 | 来源 | 理由 |
|------|------|------|
| ... | ... | ... |

### 3.3 排除项（明确不做）

| 功能/方向 | 排除理由 |
|---------|---------|
| {功能描述} | {原因：资源限制 / 非当前阶段 / 与战略不符} |

---

## 4. 依赖与风险

### 4.1 内部依赖

| 功能 | 依赖项 | 依赖类型 |
|------|-------|---------|
| {feature} | {depends-on feature} | 技术依赖 / 数据依赖 |

### 4.2 外部依赖

{外部平台、三方服务、团队协作依赖}

### 4.3 风险清单

| 风险 | 概率 | 影响 | 缓解措施 |
|------|------|------|---------|
| {风险描述} | 高/中/低 | 高/中/低 | {措施} |

---

## 5. 成功指标

| 指标 | 类型 | 目标值 | 度量方式 |
|------|------|-------|---------|
| {指标名称} | North Star / Proxy / 健康度 | {目标} | {如何度量} |

---

## 6. 下一步行动建议

| 优先级 | 行动项 | 负责角色 | 建议时间 |
|-------|-------|---------|---------|
| P0 | {行动描述} | 产品 / 研发 | {时间节点} |
| P0 | 为 P0 功能执行 `requirement` pipeline 注册 CR 并进入 PRD 编写 | 产品 Agent | 立即 |
| P1 | {行动描述} | ... | ... |

---

## 附录：数据来源追溯

- 产品快照采集时间：{快照时间}
- 参考 spec 列表：{feature-id 列表}
- 参考竞品报告：{报告 ID 列表}
- 参考市场洞察：{洞察 ID 列表}
- 参考 CR 列表：{CR-ID 列表}

---

规划范围（scope）说明

| scope 值 | 含义 | 典型 intent 关键词 | |---------|------|-----------------| | version | 单版本功能规划 | "v0.16 版本"、"下一版本" | | quarter | 季度规划 | "Q3"、"下季度"、"2026-Q4" | | annual | 年度规划 | "年度规划"、"全年规划"、"2027" | | feature-focus | 功能专项规划 | "AI 能力规划"、"研发工作台整体方向" |

---

内容生成原则

1. 数据驱动：所有分析结论必须有产品快照中的数据支撑，禁止编造
2. 优先级清晰：P0/P1/P2 必须有明确的判断依据，不能全部填 P0
3. 冲突显性化：如发现功能冲突或资源过载，必须在风险章节明确列出
4. 想法池激活：想法池中的条目是重要输入，不能忽略，有价值的条目应纳入规划或排除并说明理由
5. 竞品信号落地：竞品分析不是摆设，必须转化为对本次规划的具体启示
6. 行动项可执行：第 6 节的行动建议必须具体可执行，建议包含调用哪个 Skill 启动下一步

---

错误处理

context 为空

❌ 缺少产品上下文快照。
   请先调用 gather-product-context Skill 获取产品快照，再调用本技能。

intent 不明确

❓ 请补充规划意图：
1. 本次规划的时间范围或版本号是什么？（如 v0.16、2026-Q3）

数据严重不足（快照中大部分数据为空）

⚠ 产品快照数据较少（specs/竞品/洞察均为空或极少），生成的规划文档内容将以结构框架为主。
  建议先完善以下数据源后重新规划：
  - {缺失数据源列表}
  继续生成框架草稿？（Y/N）

---

注意事项

1. 不落盘：本技能只生成草稿内容，不直接写入文件系统
2. 完整输出：草稿必须包含所有章节，不得以"待补"代替应有内容
3. 提示落盘方式：草稿末尾必须提示用户确认后通过 engineering-docs 落盘
4. frontmatter id 留待分配：落盘时由 engineering-docs 自动分配序号，草稿中填 ``

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: xinyiai0724
• Source: xinyiai0724/tools
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.