qa-audit

Name: qa-audit
Author: BlueprintOS

24stars2forks

How to install qa-audit?

blueprintos/analysis-to-delivery/qa-audit

$npx -y skills add BlueprintOS/analysis-to-delivery --skill qa-audit

Installs into the current project.

Summary

QA 审计 — 跑全量文档质量检查,按 P0/P1/P2 严重度分级输出审计报告。设计完成、代码交接前调用本 skill,作为进入实施的最后一道硬门控,确保 P0=0 才放行。

Files · 1

View on GitHub

SKILL.md

1	# QA-Audit — 文档质量审计
2
3	## Contract
4
5	- 输入: 已完成的 01-09 编号文档,项目配置文件,知识库 / 合规 / 技术栈指针
6	- 输出: `09-QA审计报告.md`
7	- 门控: `python3 scripts/full-qa-audit.py <project>` 返回 P0=0;整改循环闭环;用户签字
8	- Required rules: `stage-gate`, `no-field-guessing`, `no-self-invent`, `sql-dialect`, `doc-numbering`, `goal-boundary`
9	- Required paths: `knowledge-path`, `tech-stack-path`, `compliance-path`, `doc-naming-path`
10	- 下一步: `/handoff`
11
12	## 适用场景
13
14	- dev-design 全部产出已签字
15	- 设计回测已通过
16	- 进入代码交接前的最后一道闸
17
18	## 流程步骤
19
20	### 1. 跑全量审计
21
22	```bash
23	python3 <SKILL_ROOT>/analysis-to-delivery/scripts/full-qa-audit.py <项目目录>
24	```
25
26	### 2. 审计维度(6 大类)
27
28	\| # \| 维度 \| 工具 \|
29	\|---\|---\|---\|
30	\| 1 \| 文档格式(frontmatter / H1 / 章节 / 链接 / 占位符) \| `doc-validate.py` \|
31	\| 2 \| 文档编号冲突 \| `full-qa-audit.py` \|
32	\| 3 \| 核心文档完整性(01/05/07 必备) \| `full-qa-audit.py` \|
33	\| 4 \| SQL 方言一致性 \| `sql-dialect-check.py` \|
34	\| 5 \| 字段映射一致性 \| `field-alignment-check.py` \|
35	\| 6 \| 删除/修改的精度 \| 人工 + `field-alignment-check.py` \|
36
37	### 3. 分级处理
38
39	\| 等级 \| 含义 \| 处理方式 \|
40	\|---\|---\|---\|
41	\| P0 \| 致命:导致交接后开发返工 \| 必须修复 \|
42	\| P1 \| 重要:影响开发效率 \| 建议修复 \|
43	\| P2 \| 提示:锦上添花 \| 可选 \|
44
45	### 4. 修复迭代
46
47	1. 首次失败 → 读错误输出 → 定位问题文件/行号 → 修复 → 重新跑
48	2. 二次失败 → 扩大搜索范围,检查关联文件 → 修复 → 重新跑
49	3. 三次失败 → 停止自动修复,输出完整错误报告,等用户决策
50
51	### 5. 写审计报告
52
53	输出 `09-QA审计报告.md`:
54
55	```markdown
56	# QA 审计报告:{项目名}
57
58	> 审计时间:{日期}
59	> 审计人:{name}
60
61	## 审计概览
62
63	- 文档总数:{N}
64	- P0:{N} ❌ 必须修复
65	- P1:{N} ⚠️ 建议修复
66	- P2:{N} 💡 可选
67
68	## 6 大类审计结果
69
70	### 1. 文档格式
71	✅/⚠️/❌
72
73	### 2. 文档编号
74	✅/⚠️/❌
75
76	### 3. 核心文档完整性
77	✅/⚠️/❌
78
79	### 4. SQL 方言
80	✅/⚠️/❌
81
82	### 5. 字段映射
83	✅/⚠️/❌
84
85	### 6. 删除/修改精度
86	✅/⚠️/❌
87
88	## P0 问题清单
89
90	\| 文件 \| 行号 \| 问题 \| 修复方案 \|
91	\|---\|---\|---\|---\|
92	\| \| \| \| \|
93
94	## 修复完成确认
95
96	- [ ] P0 全部修复
97	- [ ] 重新跑审计,P0=0
98	- [ ] 用户签字进入 `/handoff`
99	```
100
101	## 调用的 rule
102
103	- `rules/stage-gate` — 阶段 8 门控
104	- `rules/sql-dialect` — SQL 方言
105	- `rules/doc-numbering` — 文档编号
106
107	## 结束条件
108
109	- [ ] 6 大类审计全部跑过
110	- [ ] P0=0
111	- [ ] 审计报告签字(用户 + 接收方)
112
113	## 反模式
114
115	- ❌ P0 不修复就交付 — P0 必须=0 才能签字进入交接
116	- ❌ 只查 1 类(只查文档/只查代码) — 必须 6 大类(文档/流程/字段/合规/代码/性能)全跑
117	- ❌ 审计结果"看起来 OK" — 必须有证据(具体文件 + 行号 + 引用规范)
118	- ❌ 不分 P0/P1/P2 — 必须按严重程度分级,否则后续修复无法排期
119	- ❌ 跳过代码 vs 设计对比 — 必须检查"代码实现是否偏离设计"
120	- ❌ 审计报告无签字栏 — 必须含用户 + 接收方两栏(参考 rules/stage-gate.md 第 8 门)
121	- [ ] 进入 `/handoff`

People who liked this also viewed

6 picks

Type

qa-audit

24stars2forks

View on GitHub

How to install qa-audit?

blueprintos/analysis-to-delivery/qa-audit

$npx -y skills add BlueprintOS/analysis-to-delivery --skill qa-audit

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# QA-Audit — 文档质量审计
2
3	## Contract
4
5	- 输入: 已完成的 01-09 编号文档,项目配置文件,知识库 / 合规 / 技术栈指针
6	- 输出: `09-QA审计报告.md`
7	- 门控: `python3 scripts/full-qa-audit.py <project>` 返回 P0=0;整改循环闭环;用户签字
8	- Required rules: `stage-gate`, `no-field-guessing`, `no-self-invent`, `sql-dialect`, `doc-numbering`, `goal-boundary`
9	- Required paths: `knowledge-path`, `tech-stack-path`, `compliance-path`, `doc-naming-path`
10	- 下一步: `/handoff`
11
12	## 适用场景
13
14	- dev-design 全部产出已签字
15	- 设计回测已通过
16	- 进入代码交接前的最后一道闸
17
18	## 流程步骤
19
20	### 1. 跑全量审计
21
22	```bash
23	python3 <SKILL_ROOT>/analysis-to-delivery/scripts/full-qa-audit.py <项目目录>
24	```
25
26	### 2. 审计维度(6 大类)
27
28	\| # \| 维度 \| 工具 \|
29	\|---\|---\|---\|
30	\| 1 \| 文档格式(frontmatter / H1 / 章节 / 链接 / 占位符) \| `doc-validate.py` \|
31	\| 2 \| 文档编号冲突 \| `full-qa-audit.py` \|
32	\| 3 \| 核心文档完整性(01/05/07 必备) \| `full-qa-audit.py` \|
33	\| 4 \| SQL 方言一致性 \| `sql-dialect-check.py` \|
34	\| 5 \| 字段映射一致性 \| `field-alignment-check.py` \|
35	\| 6 \| 删除/修改的精度 \| 人工 + `field-alignment-check.py` \|
36
37	### 3. 分级处理
38
39	\| 等级 \| 含义 \| 处理方式 \|
40	\|---\|---\|---\|
41	\| P0 \| 致命:导致交接后开发返工 \| 必须修复 \|
42	\| P1 \| 重要:影响开发效率 \| 建议修复 \|
43	\| P2 \| 提示:锦上添花 \| 可选 \|
44
45	### 4. 修复迭代
46
47	1. 首次失败 → 读错误输出 → 定位问题文件/行号 → 修复 → 重新跑
48	2. 二次失败 → 扩大搜索范围,检查关联文件 → 修复 → 重新跑
49	3. 三次失败 → 停止自动修复,输出完整错误报告,等用户决策
50
51	### 5. 写审计报告
52
53	输出 `09-QA审计报告.md`:
54
55	```markdown
56	# QA 审计报告:{项目名}
57
58	> 审计时间:{日期}
59	> 审计人:{name}
60
61	## 审计概览
62
63	- 文档总数:{N}
64	- P0:{N} ❌ 必须修复
65	- P1:{N} ⚠️ 建议修复
66	- P2:{N} 💡 可选
67
68	## 6 大类审计结果
69
70	### 1. 文档格式
71	✅/⚠️/❌
72
73	### 2. 文档编号
74	✅/⚠️/❌
75
76	### 3. 核心文档完整性
77	✅/⚠️/❌
78
79	### 4. SQL 方言
80	✅/⚠️/❌
81
82	### 5. 字段映射
83	✅/⚠️/❌
84
85	### 6. 删除/修改精度
86	✅/⚠️/❌
87
88	## P0 问题清单
89
90	\| 文件 \| 行号 \| 问题 \| 修复方案 \|
91	\|---\|---\|---\|---\|
92	\| \| \| \| \|
93
94	## 修复完成确认
95
96	- [ ] P0 全部修复
97	- [ ] 重新跑审计,P0=0
98	- [ ] 用户签字进入 `/handoff`
99	```
100
101	## 调用的 rule
102
103	- `rules/stage-gate` — 阶段 8 门控
104	- `rules/sql-dialect` — SQL 方言
105	- `rules/doc-numbering` — 文档编号
106
107	## 结束条件
108
109	- [ ] 6 大类审计全部跑过
110	- [ ] P0=0
111	- [ ] 审计报告签字(用户 + 接收方)
112
113	## 反模式
114
115	- ❌ P0 不修复就交付 — P0 必须=0 才能签字进入交接
116	- ❌ 只查 1 类(只查文档/只查代码) — 必须 6 大类(文档/流程/字段/合规/代码/性能)全跑
117	- ❌ 审计结果"看起来 OK" — 必须有证据(具体文件 + 行号 + 引用规范)
118	- ❌ 不分 P0/P1/P2 — 必须按严重程度分级,否则后续修复无法排期
119	- ❌ 跳过代码 vs 设计对比 — 必须检查"代码实现是否偏离设计"
120	- ❌ 审计报告无签字栏 — 必须含用户 + 接收方两栏(参考 rules/stage-gate.md 第 8 门)
121	- [ ] 进入 `/handoff`

People who liked this also viewed

6 picks

Type