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 new file mode 100644 index 0000000..495b9d6 --- /dev/null +++ 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 |