Project Doc Management

管理并规范存储项目需求文档，自动读取最新版本文件，动态更新项目概览，实现文档体系的有序管理与访问。

Security Scan

The skill's instructions and requirements are consistent with a local project-document management helper: it only needs a user-provided folder path and gives filesystem-based read/write guidance.

Purpose & Capability

Name/description (项目文档管理) align with the runtime instructions: organizing, reading, and updating docs under a user-specified ProductManagement root. The skill does not request unrelated services, credentials, or binaries.

Instruction Scope

SKILL.md confines actions to reading and manipulating files under the configured PM_PATH, with example mkdir/mv/ls commands and rules for selecting latest-version files. It does not instruct the agent to read unrelated system paths, secrets, or call external endpoints.

Install Mechanism

No install spec and no code files are present (instruction-only). Nothing is written to disk by an installer, reducing attack surface.

Credentials

No required environment variables or credentials are declared. The SKILL.md asks the user to set a PM_PATH (env variable or config file) — this is proportionate for a filesystem-focused doc manager and not a request for secrets.

Persistence & Privilege

always is false and the skill is user-invocable. The default platform setting allows autonomous invocation, but there are no other elevated privileges or requests to modify other skills/configs.

Assessment

This skill operates on files under a user-configured folder (PM_PATH). Before installing: 1) Set PM_PATH to a dedicated documents folder (not your home directory or system directories). 2) Put the config (env var or ~/.project-doc-config.json) in a safe location and confirm its contents. 3) Review and backup any existing documents before running automated moves. 4) Be aware the agent will read/write files under PM_PATH; if you do not want automatic file access, avoid enabling autonomous invocation or only invoke the skill manually. If you need higher assurance, request a code-based implementation or an audit showing exactly which read/write operations the agent will perform.

项目文档管理 Skill

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

概述

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

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

---

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

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

存储方式	路径示例	说明
iCloud 云盘	/Users/{用户名}/Library/Mobile Documents/com~apple~CloudDocs/ProductManagement	多设备同步，推荐
本地存储	~/Documents/ProductManagement 或 /项目文档/ProductManagement	本地存储，无需iCloud

配置方法

在安装本 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主版本.次版本.修订号

变化类型	版本递进	示例
新增功能	次版本+1	v1.1.0
Bug修复	修订号+1	v1.1.1
重大变更	主版本+1	v2.0.0

---

3. 文件命名规范

文档类型	格式	示例
PRD	PRD-{产品线}-v{版本号}.md	PRD-波次规划-v3.2.md
评审报告	评审-{产品线}-{阶段}-v{版本号}.md	评审-波次规划-需求-v1.0.md
设计文档	{文档类型}-{产品线}-v{版本号}.md	设计-波次规划-v1.0.md
测试用例	测试用例-{产品线}-v{版本号}.md	测试用例-波次规划-v1.0.md

---

4. 阶段分类说明

阶段	英文	存放内容
01-Requirements	Requirements	PRD、需求文档、用户故事、验收标准、需求评审报告
02-Design	Design	系统设计、架构图、流程图、接口文档、设计评审报告
03-Development	Development	代码、技术方案、开发评审报告
04-Testing	Testing	测试用例、测试报告、bug记录、测试评审报告
05-Release	Release	发布说明、版本记录、运维文档

---

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

5.1 读取顺序

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

任务类型	读取顺序
PRD评审	项目概览.md → 最新PRD → 评审报告
需求分析	项目概览.md → 最新PRD + 需求分析报告 → 访谈纪要/调研报告
设计类	项目概览.md → 最新PRD + 最新设计方案
开发类	项目概览.md → 最新PRD + 技术方案
测试类	项目概览.md → 最新PRD + 测试文档
项目管理	项目概览.md → 全部相关文档

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