# dc-pm-spec

**Repository Path**: moon_gl/skill.dc-pm-spec

## Basic Information

- **Project Name**: dc-pm-spec
- **Description**: 神州数码，产品经理全流程skill技能
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-03-31
- **Last Updated**: 2026-07-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dc-pm-spec

AI 驱动的产品经理工作流 Skill，覆盖需求池、结构化 PRD、页面级 PRD、业务需求说明书交付以及测试执行等完整链路。

---

## 核心定位

本 Skill 面向以下典型场景：

1. 使用需求池管理初始需求。
2. 生成或逆向推导面向 AI/研发的结构化 PRD。
3. 对页面原型或页面代码生成页面级 PRD，并按规范评审与修订。
4. 将页面级 PRD 集合转为面向业务方的需求说明书 Markdown。
5. 将需求说明书进一步转换为 Word、执行截图并形成客户确认版交付文档。
6. 基于 PRD 生成并执行测试用例。

---

## 核心命令详解

为了实现高可维护性和解耦，本 Skill 的所有子命令和约束条件已全面目录化。

| 命令组 | 核心子命令 | 功能说明 | 详细约束见文件 |
| ---------- | -------------------------------------------------- | ---------------------------------- | ---------------- |
| `/dc:init` | 默认初始化 | 初始化 `dcspec/` 目录、需求池与项目总览文件 | `commands/init/` |
| `/dc:req` | 默认录入 | 触发需求收集、头脑风暴并写入需求池 | `commands/req/` |
| `/dc:prd` | 默认生成, `code`, `doc`, `update`, `review`, `resolve` | 双轨制文档输出与强规范版本控制；`code` 支持自动回写主 PRD 索引 | `commands/prd/` |
| `/dc:page-prd` | `draft`, `review`, `revise`, `changelog` | 页面级 PRD 起草、评审、修订与修订记录维护 | `commands/page-prd/` |
| `/dc:req-doc` | `plan`, `draft`, `screenshots-plan`, `screenshots-run`, `docx`, `package` | 业务需求说明书规划、生成、截图编排、Word 转换与最终交付打包 | `commands/req-doc/` |
| `/dc:test` | `case`, `run`, `run-auto` | 测试用例生成与自动化执行；允许生产环境但默认启用安全闸门 | `commands/test/` |

---

## 页面级 PRD 与传统 `/dc:prd` 的边界

### `/dc:prd`

适用于：
- dcspec 目录下的结构化主从 PRD。
- 面向 AI、研发、测试的系统规格文档。
- 需求池驱动或代码/原型逆向推导的主 PRD 体系。

### `/dc:page-prd`

适用于：
- 原型驱动的页面同级 PRD。
- 只描述单页面职责范围内的交互逻辑与业务规则。
- 面向业务方、产品、研发共同评审的页面说明。
- 需要按九大维度评审并维护修订记录的场景。

这两条链路并列存在，不相互替代。

---

## 业务需求说明书交付链路

新增的 `/dc:req-doc` 命令组承接“页面级 PRD -> 业务需求说明书 -> Word -> 自动截图回填”的下游交付动作。

推荐顺序：

```bash
/dc:req-doc plan [页面PRD集合]
/dc:req-doc draft [页面PRD集合]
/dc:req-doc screenshots-plan [说明书.md]
/dc:req-doc docx [说明书.md]
/dc:req-doc package [说明书.md]
```

其中：

- `plan`：规划目录、图表和截图位。
- `draft`：生成面向业务方的说明书 Markdown。
- `screenshots-plan`：提取截图任务清单。
- `docx`：将 Markdown 转为 Word。
- `package`：串联截图、Word 与回填输出最终版。

---

## 资产目录说明

为了将模板、示例、脚本真正纳入 Skill，而不是依赖业务目录中的零散文件，本 Skill 对资产进行了标准化分层：

```text
.agents/skills/dc-pm-spec/
├── commands/                 # 命令入口
├── workflows/                # 工作流逻辑
├── templates/                # 正式模板
├── references/
│   ├── standards/            # 规范摘要
│   ├── examples/             # 正式示例
│   └── debug/                # 调试与历史资产说明
└── scripts/                  # 正式自动化脚本入口
```

### 各目录职责

- `templates/`：正式输出模板，不放试验版。
- `references/standards/`：从原始规范中抽取的可执行摘要，供 workflow 直接消费。
- `references/examples/`：精选示例，用于 few-shot 和人工参考。
- `references/debug/`：调试脚本和历史版本的说明，不进入正式执行链路。
- `scripts/`：Markdown 转 Word、截图任务提取、自动截图、Word 回填等正式脚本入口。

---

## 模板、示例、脚本纳入原则

### 模板

1. 命名统一。
2. 只保留正式输出结构。
3. 不写死项目私有信息。
4. 与 workflow 一一对应。

### 示例

1. 示例只做示范，不直接当模板。
2. 保留精选、稳定、可复用的示例。
3. 标明用途，例如评审示例、说明书示例、截图任务清单示例。

### 脚本

1. 正式脚本统一进入 `scripts/`。
2. 所有正式脚本必须逐步参数化。
3. 历史版本脚本与 `explore_*.py` 不直接进入正式 workflow。
4. 如调试脚本沉淀为稳定能力，应整理后升级为正式脚本入口。

---

## 与现有项目资产的关系

Skill 内部已开始吸收以下类型资产：

1. 页面级 PRD 写作规范与评审规范的抽取版。
2. 需求说明书写作与截图规范的抽取版。
3. 页面级 PRD、评审结果、需求说明书、截图任务清单模板。
4. Markdown 转 Word、截图任务提取、自动截图、Word 回填的正式脚本入口。

原业务目录中的成熟脚本和文档仍可作为来源或样例，但 Skill 内部会逐步沉淀自己的标准化副本和正式入口。

---

## 典型用法示例

### 1. 页面级 PRD 起草与评审

```bash
/dc:page-prd draft [页面文件/原型说明]
/dc:page-prd review [页面PRD]
/dc:page-prd revise [页面PRD]
```

### 2. 业务需求说明书交付

```bash
/dc:req-doc plan [页面PRD集合]
/dc:req-doc draft [页面PRD集合]
/dc:req-doc screenshots-plan [说明书.md]
/dc:req-doc package [说明书.md]
```

### 3. 传统结构化 PRD 与测试

```bash
/dc:prd REQ-001
/dc:prd review PRD-001
/dc:test case PRD-001
```

---

## 注意事项

1. 页面级 PRD 与传统结构化 PRD 是两条不同链路，不要混用模板。
2. 说明书交付链路中的截图与 Word 转换应分阶段执行，支持单独重跑。
3. 正式 workflow 只依赖 `templates/`、`references/standards/`、`references/examples/` 和 `scripts/` 中的资产。
4. 调试与历史脚本只作参考，不承诺稳定兼容。