安装脚本bug问题

[alpha-86]

必读文档
prompts/002_develop_pipeline.md — 核心流程文档，定义完整开发交付流程（Gate 0~5）、角色职责矩阵、Human 专属操作
prompts/002_product_engineering_roles.md
prompts/003_document_contracts.md
prompts/004_delivery_gates.md
prompts/008_change_record_and_revalidation.md
prompts/013_github_issue_and_review_comments.md
prompts/016_dual_track_delivery_mechanism.md
prompts/019_dual_stage_pr_and_three_layer_safeguard.md
skills/workflows/implementation.md
skills/workflows/qa-validation.md
skills/templates/review-comment-template.md

如上是当前每个Agent的skill内容，当前他用户要安装AgentDevFlow时，通常会把AgentDevFlow安装在~/.claude/目录下，以保证该用户目录下所有的项目都能使用该能力。这样就带来问题：

1. 安装在~/.claude/目录的skill，无法读取上面的“必读文档”，因为上面哪些目录没有，或者不明确。

请看看如何解决该问题。

[github-actions]

AgentDevFlow Issue 已接收，正在处理。

任务队列: .claude/task_queue/issue_19.task

⚠️ Issue 命名格式警告
标题: 安装脚本bug问题
问题: 标题不符合 Issue_${type}#{{id}}:{{name}} 格式
正确格式: Issue_{type}#{id}:{name}，例如: Issue_feature#1:添加Telegram Bot部署说明
参考: docs/governance/issue-naming-convention.md

此评论由 GitHub Actions 自动生成

[github-actions]

AgentDevFlow Issue 已接收，正在处理。

任务队列: .claude/task_queue/issue_19.task

⚠️ Issue 命名格式警告
标题: 安装脚本bug问题
问题: 标题不符合 Issue_${type}#{{id}}:{{name}} 格式
正确格式: Issue_{type}#{id}:{name}，例如: Issue_feature#1:添加Telegram Bot部署说明
参考: docs/governance/issue-naming-convention.md

此评论由 GitHub Actions 自动生成

[github-actions]

AgentDevFlow Issue 已接收，正在处理。

任务队列: .claude/task_queue/issue_19.task

⚠️ Issue 命名格式警告
标题: 安装脚本bug问题
问题: 标题不符合 Issue_${type}#{{id}}:{{name}} 格式
正确格式: Issue_{type}#{id}:{name}，例如: Issue_feature#1:添加Telegram Bot部署说明
参考: docs/governance/issue-naming-convention.md

此评论由 GitHub Actions 自动生成

[github-actions]

AgentDevFlow Issue 已接收，正在处理。

任务队列: .claude/task_queue/issue_19.task

⚠️ Issue 命名格式警告
标题: 安装脚本bug问题
问题: 标题不符合 Issue_${type}#{{id}}:{{name}} 格式
正确格式: Issue_{type}#{id}:{name}，例如: Issue_feature#1:添加Telegram Bot部署说明
参考: docs/governance/issue-naming-convention.md

此评论由 GitHub Actions 自动生成

[github-actions]

Agent: product-manager
Date: 2026-04-22T02:28:59Z
Source: Issue #19 Comment

project_id: alpha-86-AgentDevFlow
issue_id: #19
当前阶段: Gate 1: PRD Review
owner: Product Manager

问题理解

#19 当前处理的是 AgentDevFlow 安装脚本的路径问题：当 AgentDevFlow 被安装在 ~/.claude/ 目录下时，skill 中的"必读文档"路径（如 prompts/002_develop_pipeline.md）无法被正确读取，因为安装目录与项目开发目录不同。

当前范围

1. 明确安装到 ~/.claude/ 后的文档路径映射规则
2. 确保 skill 中引用的文档路径在安装后仍然有效
3. 定义安装脚本与文档路径的统一规范

当前非目标

• 不在本 PRD 中直接修改安装脚本实现
• 不扩展到与文档路径无关的其他安装问题
• 不把历史安装经验直接作为当前有效交付物

下一步

1. 起草 安装脚本bug问题 #19 当前有效 PRD
2. 以 PRD 作为 Gate 1 输入发起三方评审
3. Gate 1 通过后再进入 Tech / QA / HR#1 正式链路

[alpha-86]

Gate 1 PRD Review — 评审启动

Issue: #19 — 安装脚本安装结果完备性与路径映射（最高优先级主线）
PRD: docs/prd/019_installation_script_doc_path_2026-04-22.md (v1 Draft)
评审方式: 三方评审（PM + Architect + QA）
日期: 2026-04-22

核心决策点

1. 安装脚本bug问题 #19 为唯一主线，安装脚本安装后 skill 硬编码路径不可用 #30 为 duplicate/background
2. 六类产物（docs/prompts/skills/workflows/shared/templates）必须同时验证
3. 安装态 skill namespace: ~/.claude/skills/ 稳定版，不要求 adf- 前缀
4. 关键入口（SKILL/workflow/template）必须真实读取
5. 五项成功判据同时满足才可宣称安装完整
6. 安装脚本安装后 skill 硬编码路径不可用 #30 不再独立推进

评审状态

• PM: ✅ 就绪确认
• QA: ✅ Approved（4 条观察意见供 Tech 阶段收口）
• Architect: ⏳ 待输出

评审记录

.claude/results/gate1_19_20260422_041500.md

[alpha-86]

Gate 1 PRD Review — 三方评审结论：Approved ✅

日期: 2026-04-22
评审方式: PM + Architect + QA 三方评审

评审结果

评审人	Verdict	备注
Product Manager	✅ Approved	评审发起，PRD 就绪确认
QA Engineer	✅ Approved	4 条观察意见供 Tech 阶段收口
Architect	✅ Approved	5 维度全部接受

核心决策确认

1. 安装脚本bug问题 #19 为唯一主线，安装脚本安装后 skill 硬编码路径不可用 #30 为 duplicate/background ✅
2. 六类产物范围（docs/prompts/skills/workflows/shared/templates）✅
3. 安装态 skill namespace: ~/.claude/skills/ 稳定版，无 adf-prefix ✅
4. 关键入口真实读取要求 ✅
5. 五项成功判据同时满足 ✅
6. 安装脚本安装后 skill 硬编码路径不可用 #30 不再独立推进 ✅

QA 观察意见（Tech 阶段收口）

1. Tech 需产出安装目标清单（artifact inventory）
2. Tech 需明确默认验证靶点入口
3. Tech 需补充告警持久化/可观测机制
4. 完备性检查输出格式需定义（JSON/exit code 等）

下一动作

• Gate 1 → Gate 2: Tech Review
• Architect 修正 Tech Spec 第21行前置状态标注
• QA Case Design 待 Gate 1+2 通过后启动三方评审

[alpha-86]

docs/prompts/skills/workflows/shared/templates 这些目录是否要打包？
从start-agent-team开始，逐层分析文件依赖，看看依赖哪些目录，意味着这些目录要打包。但是要定好规则，看看这些目录要安装在用户的什么路径。确保安装到其他用户的 ~/.claude/skills/的各个skill能正确引用文件，是否跟skill的prompts兼容。

另外，通过这一次的梳理，要在 本项目的CLAUDE.md沉淀规则，不要无限制增加产生新的目录依赖，要定好规范和规则，这样确保打包就打包这些目录。