GOV-012: Issue comment 规范缺失与文档/comment 边界治理

[alpha-86]

问题描述

当前流程存在以下 comment 和文档边界的治理缺口：

1. comment 链路不完整：每个 Gate 的文档评审应包含完整的 comment 链路（发起→评审→迭代→完成），实际经常缺失
2. Human Review 发起不规范：需要独立的 HR 发起 comment，明确标注、概括核心内容、附 PR 链接
3. comment 模板缺失：PMO 未对各类 comment 规范统一模板
4. skill/prompts 文档未覆盖：现有文档未完整涵盖 comment 规范和文档评审流程
5. comment 替代文档：Issue 安装脚本bug问题 #19 QA 测试报告仅以 comment 形式发布，缺乏独立 QA 报告文档

要求

• PMO 需审查所有 skill 和 prompts/*.md，确认是否完整涵盖 comment 规范
• PMO 需在 prompts/discuss/ 创建迭代文档，说明如何补全
• PMO 需规范各类 comment 模板

交付物

• 审查报告（skill/prompts 覆盖度分析）
• prompts/discuss/033 迭代文档
• comment 模板规范（至少5种：评审发起、评审意见、迭代回复、完成评审、HR发起）

[github-actions]

Agent: pmo
Date: 2026-04-23T07:45:16Z
Source: Issue #33 Comment

PMO 审查结论：skill/prompts 覆盖度分析

PMO 已完成对全部 skill 和 prompts/*.md 的审查，结论如下：

一、文档覆盖度总结

Prompts（核心规则）：

文档	comment 规范覆盖	缺口
002_develop_pipeline.md	14 个强制 comment 节点列表	无 comment 类型定义、无链路完整性检查、无"严禁 comment 替代文档"规则
013_github_issue_and_review_comments.md	Gate 评论最小字段、评论约束	无 comment 模板、无链路定义、无文档/comment 边界规则
017_human_review_and_signoff.md	HR 结论类型（Approved/Conditional/Rejected）	无 HR 发起 comment 规范、无独立发起模板
014_process_compliance_and_audit.md	合规检查对象包含 Issue 评论	无 comment 模板审计、无文档/comment 边界检查
020_issue_comment_gate_and_artifact_linkage.md	Comment 最小字段、产物关联	无 comment 类型定义、无链路定义

Skills（角色工作流）：

文档	comment 规范覆盖	缺口
skills/product-manager/SKILL.md	Issue 评论只放结构化结论	无 comment 类型模板引用、无 HR 发起规范
skills/qa-engineer/SKILL.md	QA 结论写回 Issue 评论和 QA report	未明确"QA report 必须是独立文档，comment 只是摘要"
skills/pmo/SKILL.md	14 个强制 comment 节点检查	无 comment 模板规范、无文档/comment 边界检查
skills/workflows/human-review.md	在 issue/纪要/PR 中留结论	无 HR 发起 comment 规范
skills/workflows/qa-validation.md	把发布准备状态写入 issue	无 QA 报告文档 vs comment 边界

Templates：

文档	状态
skills/templates/review-comment-template.md	仅有 1 个通用模板，未覆盖 5 种必要类型

二、发现的 P0 级问题

1. Issue 安装脚本bug问题 #19 QA 测试报告仅以 comment 发布，无独立 docs/qa/qa-report-019_*.md 文档 — 违反"严禁 comment 替代文档"原则
2. 无 HR 发起 comment 模板 — Human Review 发起与评审结论混为一谈
3. 无 comment 链路定义 — prompts 定义了节点，但未定义"发起→评审→迭代→完成"的完整链路

三、已创建的迭代文档

prompts/discuss/033_2026-04-23_comment规范与文档边界治理迭代计划.md 已创建，包含：

• 问题诊断（逐项分析 + 覆盖度矩阵）
• 5 种 comment 模板规范（评审发起、评审意见、迭代回复、完成评审、HR 发起）
• 文档 vs comment 边界规则（含"严禁 comment 替代文档"判定标准）
• 修改计划（prompts/.md、skills/.md、templates 的逐项修改清单）
• 执行顺序和验收标准

四、下一步动作

1. 按迭代计划 Step 1-10 逐项修改文档
2. 回溯 Issue 安装脚本bug问题 #19，补充独立 QA 报告文档
3. 所有修改通过 PR 合并（Refs GOV-012: Issue comment 规范缺失与文档/comment 边界治理 #33）

---

PMO 审查完成 | 2026-04-23