alpha-86 · alpha-86 · Apr 22, 2026
diff --git a/docs/prd/019_installation_script_doc_path_2026-04-22.md b/docs/prd/019_installation_script_doc_path_2026-04-22.md
@@ -0,0 +1,91 @@
+---
+name: 安装脚本文档路径映射规范
+description: 解决 AgentDevFlow 安装在 ~/.claude/ 后 skill 中必读文档路径失效的问题，统一安装目录与文档路径映射规则
+status: Draft
+owner: Product Manager
+date: 2026-04-22
+update_date: 2026-04-22
+issue: "#19"
+---
+
+# PRD #019 — 安装脚本文档路径映射规范
+
+## 1. 背景
+
+Issue #19 指向的核心问题是：当 AgentDevFlow 被安装在 `~/.claude/` 目录下时，skill 中引用的"必读文档"路径（如 `prompts/002_develop_pipeline.md`）无法被正确读取，因为安装后的目录结构与项目开发目录不同。
+
+## 2. 问题
+
+当前存在以下直接问题：
+
+- **安装后路径失效**：`~/.claude/skills/` 下的 skill 无法读取 `prompts/` 下的必读文档
+- **路径映射不清晰**：安装脚本未明确说明安装后文档路径如何映射
+- **skill 引用硬编码**：skill 中直接写死了项目开发目录的相对路径
+
+## 3. 目标
+
+形成当前有效的产品层需求定义，明确：
+
+1. 安装到 `~/.claude/` 后，skill 引用的文档路径必须仍然有效
+2. 必须定义安装目录与文档路径的统一映射规则
+3. skill 中的文档引用必须适配安装后的路径结构
+
+## 4. 范围
+
+### 4.1 路径映射规则
+
+- 明确项目开发目录与安装目录的对应关系
+- 明确 skill 引用文档时的路径解析规则
+- 明确当文档不存在时的 fallback 行为
+
+### 4.2 安装脚本更新范围
+
+- 安装脚本需要处理文档路径的映射
+- 安装脚本需要确保必要文档被复制到安装目录
+
+### 4.3 Skill 文档引用更新
+
+- skill 中的文档引用需要支持安装后的路径结构
+- 或采用环境变量/配置方式动态解析路径
+
+## 5. 非目标
+
+- 不在本 PRD 中直接修改安装脚本实现
+- 不扩展到与文档路径无关的其他安装问题
+- 不把历史安装经验直接作为当前有效交付物
+
+## 6. 用户故事
+
+### US-1：安装使用者
+> 作为安装 AgentDevFlow 的用户，我希望安装后 skill 中的文档引用仍然有效，不需要手动调整路径。
+
+### US-2：维护者
+> 作为维护者，我希望安装脚本能自动处理文档路径映射，避免每次更新后手动修复路径。
+
+## 7. 验收标准
+
+- [ ] 已明确安装目录与项目开发目录的文档路径映射规则
+- [ ] skill 中的文档引用在安装后仍然有效
+- [ ] 已定义文档不存在时的 fallback 行为
+- [ ] 安装脚本已考虑文档路径的自动映射
+- [ ] 本 issue 已按严格研发交付流程重新进入 Gate 1
+
+## 8. 风险
+
+| 风险 | 影响 | 缓解 |
+|------|------|------|
+| 路径映射规则过于复杂 | 中 | 采用简单的一对一映射或环境变量方式 |
+| 安装后文档更新不同步 | 高 | 明确文档同步机制或引用原项目目录 |
+| 不同操作系统路径差异 | 低 | 使用跨平台路径处理方式 |
+
+## 9. 依赖
+
+- Issue #19 当前讨论上下文
+- 当前有效安装脚本
+- 当前有效角色 SKILL 文档
+
+## 10. 评审记录
+
+| 日期 | 评审人 | 备注 | 决策 |
+|---|---|---|---|
+| 2026-04-22 | PM | 按严格研发交付流程重新启动 #19，起草当前有效 PRD | Draft |