# Planning Draft

> 基于产品上下文快照与用户意图，生成符合 DESIGN-DOC 规范的产品规划文档草稿供预览，不落盘；由 product-planning-agent 在规划场景中内部调用。

- **Type:** Skill
- **Install:** `agentstack add skill-xinyiai0724-tools-planning-draft`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [xinyiai0724](https://agentstack.voostack.com/s/xinyiai0724)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [xinyiai0724](https://github.com/xinyiai0724)
- **Source:** https://github.com/xinyiai0724/tools/tree/main/skills/planning/planning-draft

## Install

```sh
agentstack add skill-xinyiai0724-tools-planning-draft
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 产品规划草稿生成技能 (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 规范）

```markdown
---
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](https://github.com/xinyiai0724)
- **Source:** [xinyiai0724/tools](https://github.com/xinyiai0724/tools)
- **License:** Apache-2.0

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-xinyiai0724-tools-planning-draft
- Seller: https://agentstack.voostack.com/s/xinyiai0724
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.