项目文档管理 Skill

> 用于管理产品需求文档的规范化存储与读取

概述

本 Skill 用于按照文档体系规则管理和组织项目需求文档，实现：

• 文档规范化存储
• 自动读取项目上下文
• 项目概览动态更新

⚙️ 配置：指定文档根目录

安装时必须配置：指定 ProductManagement 文件夹的存放路径

配置方法

在安装本 Skill 后，需在用户配置文件中设置路径：

# 创建用户配置（安装在 ~/openclaw/workspace 或 ~/.project-doc-config）
PM_PATH="你的ProductManagement路径"
export PM_PATH

或创建一个配置文件 ~/.project-doc-config.json：

{
  "product_management_path": "/Users/你的用户名/你的路径/ProductManagement"
}

1. 目录结构

{配置的根目录}/
├── 00-Templates/              # 通用模板
├── {产品线}/
│   ├── 项目概览.md             # 必读：项目全局信息
│   ├── 01-Requirements/       # 需求阶段
│   ├── 02-Design/             # 设计阶段
│   ├── 03-Development/        # 开发阶段
│   ├── 04-Testing/            # 测试阶段
│   └── 05-Release/            # 发布阶段
└── archive/                   # 历史归档

2. 版本命名规则

采用 SemVer：v主版本.次版本.修订号

3. 文件命名规范

4. 阶段分类说明

5. 任务执行时的文档读取规则

5.1 读取顺序

收到项目任务时，按以下顺序读取文档：

5.2 版本规则

• 默认：只读取最新版本的文件（文件名中版本号最高的）
• 历史版本：仅在用户明确指定时读取

5.3 示例

• 任务涉及"波次规划" → 读取 {PM_PATH}/波次规划/项目概览.md + 波次规划/01-Requirements/ 下最新PRD
• 任务涉及"智能报价设计" → 读取 {PM_PATH}/智能报价/项目概览.md + 智能报价/02-Design/ 下最新设计

6. 动态更新规则

当产品线文档发生重大更新时，必须同步更新 项目概览.md：

• 更新当前版本号
• 补充/修改核心功能清单
• 记录待解决问题变更
• 更新最后更新时间

7. 新建产品线

1. 在配置的根目录下创建产品线目录
2. 创建标准阶段目录：01-Requirements、02-Design、03-Development、04-Testing、05-Release
3. 创建 项目概览.md，包含：
• 项目背景与目标
• 当前版本
• 核心功能清单
• 待解决问题

8. 文件迁移命令示例

# 使用配置的路径变量
PM="{你的ProductManagement路径}"

# 新建产品线目录
mkdir -p "$PM/新产品线/01-Requirements"
mkdir -p "$PM/新产品线/02-Design"

# 移动文件到对应阶段
mv ~/workspace/file.md "$PM/新产品线/01-Requirements/"

📋 首次安装检查清单

• [ ] 确认 ProductManagement 文件夹路径
• [ ] 创建/配置用户配置文件（设置 PM_PATH）
• [ ] 验证路径可访问：ls {PM_PATH}
• [ ] 确认目录结构符合规范（如有旧文档需迁移）

最后更新：2026-04-10