qa-audit

name	qa-audit
description	QA 审计 — 跑全量文档质量检查,按 P0/P1/P2 分级输出审计报告。Use when design is done and before code handoff.
disable-model-invocation	true

QA-Audit — 文档质量审计

适用场景

• dev-design 全部产出已签字
• 设计回测已通过
• 进入代码交接前的最后一道闸

流程步骤

1. 跑全量审计

python3 ~/.claude/skills/analysis-to-delivery/scripts/full-qa-audit.py <项目目录>

2. 审计维度(6 大类)

#	维度	工具
1	文档格式(frontmatter / H1 / 章节 / 链接 / 占位符)	doc-validate.py
2	文档编号冲突	full-qa-audit.py
3	核心文档完整性(01/05/07 必备)	full-qa-audit.py
4	SQL 方言一致性	sql-dialect-check.py
5	字段映射一致性	field-alignment-check.py
6	删除/修改的精度	人工 + field-alignment-check.py

3. 分级处理

等级	含义	处理方式
P0	致命:导致交接后开发返工	必须修复
P1	重要:影响开发效率	建议修复
P2	提示:锦上添花	可选

4. 修复迭代

1. 首次失败 → 读错误输出 → 定位问题文件/行号 → 修复 → 重新跑
2. 二次失败 → 扩大搜索范围,检查关联文件 → 修复 → 重新跑
3. 三次失败 → 停止自动修复,输出完整错误报告,等用户决策

5. 写审计报告

输出 09-QA审计报告.md:

# QA 审计报告:{项目名}

> 审计时间:{日期}
> 审计人:{name}

## 审计概览

- 文档总数:{N}
- P0:{N}  ❌ 必须修复
- P1:{N}  ⚠️ 建议修复
- P2:{N}  💡 可选

## 6 大类审计结果

### 1. 文档格式
✅/⚠️/❌

### 2. 文档编号
✅/⚠️/❌

### 3. 核心文档完整性
✅/⚠️/❌

### 4. SQL 方言
✅/⚠️/❌

### 5. 字段映射
✅/⚠️/❌

### 6. 删除/修改精度
✅/⚠️/❌

## P0 问题清单

| 文件 | 行号 | 问题 | 修复方案 |
|---|---|---|---|
| | | | |

## 修复完成确认

- [ ] P0 全部修复
- [ ] 重新跑审计,P0=0
- [ ] 用户签字进入 `/handoff`

调用的 discipline

• disciplines/stage-gate — 阶段 9 门控
• disciplines/sql-dialect-discipline — SQL 方言
• disciplines/doc-numbering — 文档编号

结束条件

• 6 大类审计全部跑过
• P0=0
• 审计报告签字(用户 + 接收方)
• 进入 /handoff