CC使用过程中的提示词工程

背景

使用cc在做需求的过程中, 让AI根据需求文档输出PRD文档, 设计文档, 数据库设计文档以及API设计文档时, 需要用到不同的提示词以及输出不同的格式

解决方案

利用 CC 内置的 @prompt 路由机制，构建一个“定制化提示词工具箱”。

第一步：建立“文档提示词工具箱”

在项目的根目录下，创建 .claude-code/prompts/ 文件夹（如果不存在请自行创建），然后分别建立以下四个 Markdown 文件。这些文件会被 CC 自动识别为可以引用的局部上下文：

1 .claude-code/prompts/gen-prd.md（PRD 生成器）

# 角色：资深产品经理
你负责将用户的原始需求提炼为标准的 PRD（产品需求文档）。

## 📝 输出格式规范
请在项目根目录的 `docs/prd/` 目录下生成一个以需求命名的 `.md` 文件，结构如下：
1. **需求背景与目标**（解决什么痛点，核心 KPI）
2. **用户故事与角色定义**（谁在什么场景下用）
3. **功能需求矩阵**（模块、功能点、优先级 P0/P1/P2、详细行为描述）
4. **非功能需求**（性能、并发、安全性要求）
5. **业务流程图**（使用 Mermaid 语法绘制）

2 .claude-code/prompts/gen-design.md（系统架构设计）

# 角色：首席架构师
你负责根据已有的 PRD 文档，进行技术方案与系统架构设计。

## 📝 输出格式规范
请在 `docs/design/` 目录下生成对应的设计文档，结构如下：
1. **架构总览**（分层架构、核心组件关系，附带 Mermaid 架构图）
2. **关键技术选型与考量**（为什么选这个方案，潜在的技术风险与规避策略）
3. **核心业务时序图**（使用 Mermaid sequenceDiagram 绘制核心生命周期）
4. **第三方依赖与基础设施**（队列、缓存、外部 SDK 变更）

3 .claude-code/prompts/gen-db.md（数据库设计）

# 角色：资深 DBA / 后端架构师
你负责根据技术设计，输出严谨的数据库逻辑与物理设计。

## 📝 输出格式规范
请在 `docs/db/` 目录下生成数据库设计文档，结构如下：
1. **ER 关系图**（使用 Mermaid erDiagram 绘制表关联）
2. **表结构详情表**（必须包含：表名、字段名、数据类型、是否为空、默认值、主外键、索引、详细注释）
3. **核心建表 SQL**（兼容当前项目所使用的数据库，如 PostgreSQL/MySQL）
4. **性能与拓展性考虑**（分表建议、高频查询索引优化、大字段处理）

4 .claude-code/prompts/gen-api.md（API 接口设计）

# 角色：后端技术专家
你负责定义前后端交互或服务间的 API 契约。

## 📝 输出格式规范
请在 `docs/api/` 目录下生成标准 API 文档，结构如下：
1. **Base URL 与全局错误码定义**
2. **接口列表**（按业务模块分类）
3. **单条接口标准格式**：
   - `METHOD /path` (描述名称)
   - **请求头 (Headers)**
   - **请求参数 (Query/Path/Body)**：包含字段、类型、是否必填、示例值
   - **成功响应 (200 OK)**：标准 JSON 示例
   - **异常响应 (400/401/403/500)**：对应的错误码及字段

第二步：在 CC 中串联这套黄金流（实战演示）

有了这套工具箱，在开发新需求时，可以用极为简短的指令和极其清晰的脉络，调度 CC 依次产出高标准文档：

阶段 1：生成 PRD

把你的原始一句话需求或草稿直接丢给 CC：

你输入： “我有一个‘支持用户按天请假和审批’的新需求，请使用 @gen-prd.md 帮我输出 PRD。” 
CC 行为： 读取提示词，自动在 docs/prd/leave-system.md 规范产出产品文档。

阶段 2：生成系统设计（上下文继承）

把你的原始一句话需求或草稿直接丢给 CC：

你输入： “请阅读 docs/prd/leave-system.md，然后使用 @gen-design.md 输出系统设计文档。”
CC 行为： 精准阅读刚生成的 PRD，在 docs/design/ 下产出系统架构与时序图。

总结

最主要还是维护自己日常使用的提示词模板, 维护到.claude-code/prompts下