chore: A+B+C方案 — 必读文档强制化 + bootstrap-sync修复 + 启动强制检查

方案A: start-agent-team 新增步骤4.1-4.4强制检查机制
方案B: 11个Skill文件必读文档章节统一强制格式
方案C: bootstrap-sync.py 排除workflows/templates误替换bug

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: alpha-86

.github/workflows/bootstrap-sync.py

@@ -93,6 +93,9 @@ def build_name_mapping() -> dict[str, str]:
         if not subdir.is_dir():
             continue
         name = subdir.name
+        # Exclude workflows and templates — they are shared dirs, not individual skills
+        if name in ("workflows", "templates"):
+            continue
         mapping[name] = f"adf-{name}"
 
     return mapping
@@ -295,6 +298,9 @@ def main():
             continue
 
         subdir_name = subdir_path.name
+        # Exclude workflows and templates — shared dirs, not individual skills
+        if subdir_name in ("workflows", "templates"):
+            continue
         adf_subdir_name = mapping.get(subdir_name, f"adf-{subdir_name}")
 
         if dry_run:

skills/agent-bootstrap/SKILL.md

@@ -13,15 +13,26 @@
 | 重点 | 建立交付目录、Issue、团队 | 建立 AgentDevFlow 自身治理 + 交付机制 |
 | 角色来源 | `skills/{role}.md` | `skills/{role}.md` (自身) |
 
-## 执行前必读
-
-1. `skills/start-agent-team.md`
-2. `skills/skill-protocol.md`
-3. `skills/event-bus.md`
-4. `prompts/001_team_topology.md`
-5. `prompts/010_team_setup_and_bootstrap.md`
-6. `docs/governance/core-principles.md`
-7. `README.md`
+## 必读文档 ⚠️ 强制
+
+> **强制要求**：以下文档必须在开始任何工作前**全部阅读完毕**，不得遗漏任何一项。未完整阅读不得进入工作状态。
+
+| # | 文档 | 用途 | 状态 |
+|---|------|------|------|
+| 1 | `prompts/002_develop_pipeline.md` | 核心流程文档，定义完整开发交付流程（Gate 0~5）、角色职责矩阵、Human 专属操作 | ⬜ 未读 |
+| 2 | `skills/start-agent-team.md` | 启动团队规范 | ⬜ 未读 |
+| 3 | `skills/skill-protocol.md` | 共享技能协议 | ⬜ 未读 |
+| 4 | `skills/event-bus.md` | 事件总线规范 | ⬜ 未读 |
+| 5 | `prompts/001_team_topology.md` | 团队拓扑、Human vs Agent 角色区分 | ⬜ 未读 |
+| 6 | `prompts/010_team_setup_and_bootstrap.md` | 团队启动与自举机制 | ⬜ 未读 |
+| 7 | `docs/governance/core-principles.md` | 核心治理原则 | ⬜ 未读 |
+| 8 | `README.md` | 项目自述文件 | ⬜ 未读 |
+
+**强制规则**：
+- 必读文档全部 ✅ 已读前，**不得执行任何 Gate 动作**
+- 必读文档全部 ✅ 已读前，**不得发布任何正式结论**
+- 必读文档全部 ✅ 已读前，**不得代替其他角色做决策**
+- **未完整阅读全部必读文档，不得开始任何工作**
 
 ## 自举步骤
 

skills/architect/SKILL.md

@@ -65,21 +65,32 @@ Architect 主持评审但不签自己的 Tech Spec。
 
 > **说明**：增强层默认关闭。未安装时回落至原生机制，不报错不阻断。详见 [增强层文档](../../docs/platforms/enhancement-layer.md)。
 
-## 必读文档
-
-1. `prompts/002_product_engineering_roles.md`
-2. `prompts/003_document_contracts.md`
-3. `prompts/004_delivery_gates.md`
-4. `prompts/008_change_record_and_revalidation.md`
-5. `prompts/013_github_issue_and_review_comments.md`
-6. `prompts/017_human_review_and_signoff.md`
-7. `prompts/019_dual_stage_pr_and_three_layer_safeguard.md`
-8. `prompts/021_platform_checks_and_gate_automation.md`
-9. `skills/workflows/tech-review.md`
-10. `skills/workflows/human-review.md`
-11. `skills/workflows/implementation.md`
-12. `skills/templates/tech-spec-template.md`
-13. `skills/templates/review-comment-template.md`
+## 必读文档 ⚠️ 强制
+
+> **强制要求**：以下文档必须在开始任何工作前**全部阅读完毕**，不得遗漏任何一项。未完整阅读不得进入工作状态。
+
+| # | 文档 | 用途 | 状态 |
+|---|------|------|------|
+| 1 | `prompts/002_develop_pipeline.md` | 核心流程文档，定义完整开发交付流程（Gate 0~5）、角色职责矩阵、Human 专属操作 | ⬜ 未读 |
+| 2 | `prompts/002_product_engineering_roles.md` | 角色强制规则 | ⬜ 未读 |
+| 3 | `prompts/003_document_contracts.md` | 文档契约与命名规范 | ⬜ 未读 |
+| 4 | `prompts/004_delivery_gates.md` | Gate 合规检查定义 | ⬜ 未读 |
+| 5 | `prompts/008_change_record_and_revalidation.md` | 变更记录与重审机制 | ⬜ 未读 |
+| 6 | `prompts/013_github_issue_and_review_comments.md` | Issue/评论规范 | ⬜ 未读 |
+| 7 | `prompts/017_human_review_and_signoff.md` | Human Review 规范 | ⬜ 未读 |
+| 8 | `prompts/019_dual_stage_pr_and_three_layer_safeguard.md` | 双阶段 PR | ⬜ 未读 |
+| 9 | `prompts/021_platform_checks_and_gate_automation.md` | 平台检查与 Gate 自动化 | ⬜ 未读 |
+| 10 | `skills/workflows/tech-review.md` | Tech Review 工作流 | ⬜ 未读 |
+| 11 | `skills/workflows/human-review.md` | Human Review 工作流 | ⬜ 未读 |
+| 12 | `skills/workflows/implementation.md` | 实现工作流 | ⬜ 未读 |
+| 13 | `skills/templates/tech-spec-template.md` | Tech Spec 模板 | ⬜ 未读 |
+| 14 | `skills/templates/review-comment-template.md` | 评审评论模板 | ⬜ 未读 |
+
+**强制规则**：
+- 必读文档全部 ✅ 已读前，**不得执行任何 Gate 动作**
+- 必读文档全部 ✅ 已读前，**不得发布任何正式结论**
+- 必读文档全部 ✅ 已读前，**不得代替其他角色做决策**
+- **未完整阅读全部必读文档，不得开始任何工作**
 
 ## 初始化后必做
 

skills/engineer/SKILL.md

@@ -79,19 +79,29 @@ Engineer 的工作流关键路径：
 
 > **说明**：增强层默认关闭。未安装时回落至原生机制，不报错不阻断。详见 [增强层文档](../../docs/platforms/enhancement-layer.md)。
 
-## 必读文档
-
-1. **`prompts/002_develop_pipeline.md`** — **核心流程文档**，定义完整开发交付流程（Gate 0~5）、角色职责矩阵、Human 专属操作
-2. `prompts/002_product_engineering_roles.md`
-2. `prompts/003_document_contracts.md`
-3. `prompts/004_delivery_gates.md`
-4. `prompts/008_change_record_and_revalidation.md`
-5. `prompts/013_github_issue_and_review_comments.md`
-6. `prompts/016_dual_track_delivery_mechanism.md`
-7. `prompts/019_dual_stage_pr_and_three_layer_safeguard.md`
-8. `skills/workflows/implementation.md`
-9. `skills/workflows/qa-validation.md`
-10. `skills/templates/review-comment-template.md`
+## 必读文档 ⚠️ 强制
+
+> **强制要求**：以下文档必须在开始任何工作前**全部阅读完毕**，不得遗漏任何一项。未完整阅读不得进入工作状态。
+
+| # | 文档 | 用途 | 状态 |
+|---|------|------|------|
+| 1 | `prompts/002_develop_pipeline.md` | 核心流程文档，定义完整开发交付流程（Gate 0~5）、角色职责矩阵、Human 专属操作 | ⬜ 未读 |
+| 2 | `prompts/002_product_engineering_roles.md` | 角色强制规则 | ⬜ 未读 |
+| 3 | `prompts/003_document_contracts.md` | 文档契约与命名规范 | ⬜ 未读 |
+| 4 | `prompts/004_delivery_gates.md` | Gate 合规检查定义 | ⬜ 未读 |
+| 5 | `prompts/008_change_record_and_revalidation.md` | 变更记录与重审机制 | ⬜ 未读 |
+| 6 | `prompts/013_github_issue_and_review_comments.md` | Issue/评论规范 | ⬜ 未读 |
+| 7 | `prompts/016_dual_track_delivery_mechanism.md` | 双轨交付机制 | ⬜ 未读 |
+| 8 | `prompts/019_dual_stage_pr_and_three_layer_safeguard.md` | 双阶段 PR | ⬜ 未读 |
+| 9 | `skills/workflows/implementation.md` | 实现工作流 | ⬜ 未读 |
+| 10 | `skills/workflows/qa-validation.md` | QA 验证工作流 | ⬜ 未读 |
+| 11 | `skills/templates/review-comment-template.md` | 评审评论模板 | ⬜ 未读 |
+
+**强制规则**：
+- 必读文档全部 ✅ 已读前，**不得执行任何 Gate 动作**
+- 必读文档全部 ✅ 已读前，**不得发布任何正式结论**
+- 必读文档全部 ✅ 已读前，**不得代替其他角色做决策**
+- **未完整阅读全部必读文档，不得开始任何工作**
 
 ## 何时启用
 

skills/platform-sre/SKILL.md

@@ -51,18 +51,29 @@ Platform/SRE 不在 Gate 签字表中（Gate 5 由 PM + Architect 签字），
 | Gate 4 | 监控部署准备状态 | 代替 QA 做质量结论 | 确认部署路径正常 |
 | Gate 5 | 主持发布评审、持有运行风险意见、签字 | 代替 Human 做发布决策 | 确认发布完成 |
 
-## 必读文档
-
-1. `prompts/004_delivery_gates.md`
-2. `prompts/012_anomaly_and_escalation_loop.md`
-3. `prompts/013_github_issue_and_review_comments.md`
-4. `prompts/019_dual_stage_pr_and_three_layer_safeguard.md`
-5. `prompts/021_platform_checks_and_gate_automation.md`
-6. `docs/governance/platform-minimum-checks.md`
-7. `skills/workflows/release-review.md`
-8. `skills/workflows/anomaly-response.md`
-9. `skills/templates/release-record-template.md`
-10. `skills/templates/platform-check-result-template.md`
+## 必读文档 ⚠️ 强制
+
+> **强制要求**：以下文档必须在开始任何工作前**全部阅读完毕**，不得遗漏任何一项。未完整阅读不得进入工作状态。
+
+| # | 文档 | 用途 | 状态 |
+|---|------|------|------|
+| 1 | `prompts/002_develop_pipeline.md` | 核心流程文档，定义完整开发交付流程（Gate 0~5）、角色职责矩阵、Human 专属操作 | ⬜ 未读 |
+| 2 | `prompts/004_delivery_gates.md` | Gate 合规检查定义 | ⬜ 未读 |
+| 3 | `prompts/012_anomaly_and_escalation_loop.md` | 异常与升级机制 | ⬜ 未读 |
+| 4 | `prompts/013_github_issue_and_review_comments.md` | Issue/评论规范 | ⬜ 未读 |
+| 5 | `prompts/019_dual_stage_pr_and_three_layer_safeguard.md` | 双阶段 PR | ⬜ 未读 |
+| 6 | `prompts/021_platform_checks_and_gate_automation.md` | 平台检查与 Gate 自动化 | ⬜ 未读 |
+| 7 | `docs/governance/platform-minimum-checks.md` | 平台最小检查定义 | ⬜ 未读 |
+| 8 | `skills/workflows/release-review.md` | Release 评审工作流 | ⬜ 未读 |
+| 9 | `skills/workflows/anomaly-response.md` | 异常响应工作流 | ⬜ 未读 |
+| 10 | `skills/templates/release-record-template.md` | Release 记录模板 | ⬜ 未读 |
+| 11 | `skills/templates/platform-check-result-template.md` | 平台检查结果模板 | ⬜ 未读 |
+
+**强制规则**：
+- 必读文档全部 ✅ 已读前，**不得执行任何 Gate 动作**
+- 必读文档全部 ✅ 已读前，**不得发布任何正式结论**
+- 必读文档全部 ✅ 已读前，**不得代替其他角色做决策**
+- **未完整阅读全部必读文档，不得开始任何工作**
 
 ## 何时启用
 

skills/pmo/SKILL.md

@@ -87,22 +87,32 @@ PMO 的工作流关键路径：
 - 例外审批检查
 - 每次 PR 创建后的主动合规检查
 
-## 必读文档
-
-1. **`prompts/002_develop_pipeline.md`** — **核心流程文档**，定义完整开发交付流程（Gate 0~5）、角色职责矩阵、Human 专属操作
-2. `docs/governance/core-principles.md`
-3. `prompts/004_delivery_gates.md`
-4. `prompts/007_issue_driven_orchestration.md`
-5. `prompts/013_github_issue_and_review_comments.md`
-6. `prompts/014_process_compliance_and_audit.md`
-7. `prompts/017_human_review_and_signoff.md`
-8. `prompts/019_dual_stage_pr_and_three_layer_safeguard.md`
-9. `prompts/020_issue_comment_gate_and_artifact_linkage.md`
-10. `prompts/021_platform_checks_and_gate_automation.md`
-11. `skills/workflows/issue-lifecycle.md`
-12. `skills/workflows/project-portfolio-review.md`
-13. `skills/templates/audit-report-template.md`
-14. `skills/templates/review-comment-template.md`
+## 必读文档 ⚠️ 强制
+
+> **强制要求**：以下文档必须在开始任何工作前**全部阅读完毕**，不得遗漏任何一项。未完整阅读不得进入工作状态。
+
+| # | 文档 | 用途 | 状态 |
+|---|------|------|------|
+| 1 | `prompts/002_develop_pipeline.md` | 核心流程文档，定义完整开发交付流程（Gate 0~5）、角色职责矩阵、Human 专属操作 | ⬜ 未读 |
+| 2 | `docs/governance/core-principles.md` | 核心治理原则 | ⬜ 未读 |
+| 3 | `prompts/004_delivery_gates.md` | Gate 合规检查定义 | ⬜ 未读 |
+| 4 | `prompts/007_issue_driven_orchestration.md` | Issue 驱动编排机制 | ⬜ 未读 |
+| 5 | `prompts/013_github_issue_and_review_comments.md` | Issue/评论规范 | ⬜ 未读 |
+| 6 | `prompts/014_process_compliance_and_audit.md` | 流程合规与审计 | ⬜ 未读 |
+| 7 | `prompts/017_human_review_and_signoff.md` | Human Review 规范 | ⬜ 未读 |
+| 8 | `prompts/019_dual_stage_pr_and_three_layer_safeguard.md` | 双阶段 PR | ⬜ 未读 |
+| 9 | `prompts/020_issue_comment_gate_and_artifact_linkage.md` | Issue Comment Gate 与产物关联 | ⬜ 未读 |
+| 10 | `prompts/021_platform_checks_and_gate_automation.md` | 平台检查与 Gate 自动化 | ⬜ 未读 |
+| 11 | `skills/workflows/issue-lifecycle.md` | Issue 生命周期工作流 | ⬜ 未读 |
+| 12 | `skills/workflows/project-portfolio-review.md` | 项目组合评审工作流 | ⬜ 未读 |
+| 13 | `skills/templates/audit-report-template.md` | 审计报告模板 | ⬜ 未读 |
+| 14 | `skills/templates/review-comment-template.md` | 评审评论模板 | ⬜ 未读 |
+
+**强制规则**：
+- 必读文档全部 ✅ 已读前，**不得执行任何 Gate 动作**
+- 必读文档全部 ✅ 已读前，**不得发布任何正式结论**
+- 必读文档全部 ✅ 已读前，**不得代替其他角色做决策**
+- **未完整阅读全部必读文档，不得开始任何工作**
 
 ## 初始化后必做
 

skills/product-manager/SKILL.md

@@ -75,22 +75,32 @@ PM 不得以任何理由替代 Human 执行合并操作或关闭 Issue。
 
 > **说明**：增强层默认关闭。未安装时回落至原生机制，不报错不阻断。详见 [增强层文档](../../docs/platforms/enhancement-layer.md)。
 
-## 必读文档
-
-1. **`prompts/002_develop_pipeline.md`** — **核心流程文档**，定义完整开发交付流程（Gate 0~5）、角色职责矩阵、Human 专属操作
-2. `prompts/001_team_topology.md` — 团队拓扑、Human vs Agent 角色区分
-3. `prompts/002_product_engineering_roles.md` — 角色强制规则
-4. `prompts/003_document_contracts.md` — 文档契约与命名规范
-5. `prompts/004_delivery_gates.md` — Gate 合规检查定义
-6. `prompts/007_issue_driven_orchestration.md` — Issue 驱动编排机制
-7. `prompts/013_github_issue_and_review_comments.md` — Issue/评论规范
-8. `prompts/017_human_review_and_signoff.md` — Human Review 规范
-9. `prompts/019_dual_stage_pr_and_three_layer_safeguard.md` — 双阶段 PR
-10. `skills/workflows/prd-review.md`
-11. `skills/workflows/human-review.md`
-12. `skills/workflows/issue-lifecycle.md`
-13. `skills/templates/prd-template.md`
-14. `skills/templates/review-comment-template.md`
+## 必读文档 ⚠️ 强制
+
+> **强制要求**：以下文档必须在开始任何工作前**全部阅读完毕**，不得遗漏任何一项。未完整阅读不得进入工作状态。
+
+| # | 文档 | 用途 | 状态 |
+|---|------|------|------|
+| 1 | `prompts/002_develop_pipeline.md` | 核心流程文档，定义完整开发交付流程（Gate 0~5）、角色职责矩阵、Human 专属操作 | ⬜ 未读 |
+| 2 | `prompts/001_team_topology.md` | 团队拓扑、Human vs Agent 角色区分 | ⬜ 未读 |
+| 3 | `prompts/002_product_engineering_roles.md` | 角色强制规则 | ⬜ 未读 |
+| 4 | `prompts/003_document_contracts.md` | 文档契约与命名规范 | ⬜ 未读 |
+| 5 | `prompts/004_delivery_gates.md` | Gate 合规检查定义 | ⬜ 未读 |
+| 6 | `prompts/007_issue_driven_orchestration.md` | Issue 驱动编排机制 | ⬜ 未读 |
+| 7 | `prompts/013_github_issue_and_review_comments.md` | Issue/评论规范 | ⬜ 未读 |
+| 8 | `prompts/017_human_review_and_signoff.md` | Human Review 规范 | ⬜ 未读 |
+| 9 | `prompts/019_dual_stage_pr_and_three_layer_safeguard.md` | 双阶段 PR | ⬜ 未读 |
+| 10 | `skills/workflows/prd-review.md` | PRD 评审工作流 | ⬜ 未读 |
+| 11 | `skills/workflows/human-review.md` | Human Review 工作流 | ⬜ 未读 |
+| 12 | `skills/workflows/issue-lifecycle.md` | Issue 生命周期工作流 | ⬜ 未读 |
+| 13 | `skills/templates/prd-template.md` | PRD 模板 | ⬜ 未读 |
+| 14 | `skills/templates/review-comment-template.md` | 评审评论模板 | ⬜ 未读 |
+
+**强制规则**：
+- 必读文档全部 ✅ 已读前，**不得执行任何 Gate 动作**
+- 必读文档全部 ✅ 已读前，**不得发布任何正式结论**
+- 必读文档全部 ✅ 已读前，**不得代替其他角色做决策**
+- **未完整阅读全部必读文档，不得开始任何工作**
 
 ## 何时启用
 

skills/qa-engineer/SKILL.md

@@ -107,23 +107,33 @@ QA Agent 在创建测试 Issue 时，必须在 Issue 中明确关联来源 PRD
 - 缺陷记录必须关联到触发该缺陷的 PRD 验收标准
 - 在 Issue 评论中更新测试状态并链接 QA 报告
 
-## 必读文档
-
-1. **`prompts/002_develop_pipeline.md`** — **核心流程文档**，定义完整开发交付流程（Gate 0~5）、角色职责矩阵、Human 专属操作
-2. `prompts/002_product_engineering_roles.md`
-2. `prompts/003_document_contracts.md`
-3. `prompts/004_delivery_gates.md`
-4. `prompts/013_github_issue_and_review_comments.md`
-5. `prompts/017_human_review_and_signoff.md`
-6. `prompts/019_dual_stage_pr_and_three_layer_safeguard.md`
-7. `prompts/020_issue_comment_gate_and_artifact_linkage.md`
-8. `skills/workflows/tech-review.md`
-9. `skills/workflows/qa-validation.md`
-10. `skills/workflows/release-review.md`
-11. `skills/workflows/human-review.md`
-12. `skills/templates/qa-case-template.md`
-13. `skills/templates/qa-report-template.md`
-14. `skills/templates/review-comment-template.md`
+## 必读文档 ⚠️ 强制
+
+> **强制要求**：以下文档必须在开始任何工作前**全部阅读完毕**，不得遗漏任何一项。未完整阅读不得进入工作状态。
+
+| # | 文档 | 用途 | 状态 |
+|---|------|------|------|
+| 1 | `prompts/002_develop_pipeline.md` | 核心流程文档，定义完整开发交付流程（Gate 0~5）、角色职责矩阵、Human 专属操作 | ⬜ 未读 |
+| 2 | `prompts/002_product_engineering_roles.md` | 角色强制规则 | ⬜ 未读 |
+| 3 | `prompts/003_document_contracts.md` | 文档契约与命名规范 | ⬜ 未读 |
+| 4 | `prompts/004_delivery_gates.md` | Gate 合规检查定义 | ⬜ 未读 |
+| 5 | `prompts/013_github_issue_and_review_comments.md` | Issue/评论规范 | ⬜ 未读 |
+| 6 | `prompts/017_human_review_and_signoff.md` | Human Review 规范 | ⬜ 未读 |
+| 7 | `prompts/019_dual_stage_pr_and_three_layer_safeguard.md` | 双阶段 PR | ⬜ 未读 |
+| 8 | `prompts/020_issue_comment_gate_and_artifact_linkage.md` | Issue Comment Gate 与产物关联 | ⬜ 未读 |
+| 9 | `skills/workflows/tech-review.md` | Tech Review 工作流 | ⬜ 未读 |
+| 10 | `skills/workflows/qa-validation.md` | QA 验证工作流 | ⬜ 未读 |
+| 11 | `skills/workflows/release-review.md` | Release 评审工作流 | ⬜ 未读 |
+| 12 | `skills/workflows/human-review.md` | Human Review 工作流 | ⬜ 未读 |
+| 13 | `skills/templates/qa-case-template.md` | QA Case 模板 | ⬜ 未读 |
+| 14 | `skills/templates/qa-report-template.md` | QA 报告模板 | ⬜ 未读 |
+| 15 | `skills/templates/review-comment-template.md` | 评审评论模板 | ⬜ 未读 |
+
+**强制规则**：
+- 必读文档全部 ✅ 已读前，**不得执行任何 Gate 动作**
+- 必读文档全部 ✅ 已读前，**不得发布任何正式结论**
+- 必读文档全部 ✅ 已读前，**不得代替其他角色做决策**
+- **未完整阅读全部必读文档，不得开始任何工作**
 
 ## 何时启用
 

skills/skill-protocol.md

@@ -1,3 +1,19 @@
+## 必读文档 ⚠️ 强制
+
+> **强制要求**：以下文档必须在开始任何工作前**全部阅读完毕**，不得遗漏任何一项。未完整阅读不得进入工作状态。
+
+| # | 文档 | 用途 | 状态 |
+|---|------|------|------|
+| 1 | `prompts/002_develop_pipeline.md` | 核心流程文档，定义完整开发交付流程（Gate 0~5）、角色职责矩阵、Human 专属操作 | ⬜ 未读 |
+| 2 | `prompts/001_team_topology.md` | 团队拓扑、Human vs Agent 角色区分 | ⬜ 未读 |
+| 3 | `skills/event-bus.md` | 事件总线规范 | ⬜ 未读 |
+
+**强制规则**：
+- 必读文档全部 ✅ 已读前，**不得执行任何 Gate 动作**
+- 必读文档全部 ✅ 已读前，**不得发布任何正式结论**
+- 必读文档全部 ✅ 已读前，**不得代替其他角色做决策**
+- **未完整阅读全部必读文档，不得开始任何工作**
+
 # 共享技能协议
 
 ## 目标