Compliance Audit Skill 用于在 PR 推送后验证本次工作会话是否遵循了 Value Delivery 规则。
使用时机
- PR 推送之后(由 push-pr 模式调用)。
- 手动调用,方式为输入“use compliance-audit skill”。
- 需要回顾会话质量时。
阶段一:收集会话数据
从当前会话收集以下数据:
| 数据项 | 来源 |
|---|---|
| 提交数 | git rev-list origin/develop..HEAD --count |
| 变更文件数 | git diff origin/develop --name-only |
| 代码行数 | git diff origin/develop --stat |
| console.log 存在情况 | 在变更文件中 Grep |
阶段二:检查合规要求
2.1 PR 阈值检查
| 指标 | 当前值 | 阈值 | 状态 |
|---|---|---|---|
| 代码行数 | [N] | 300 | OK/CROSSED ([X]x) |
| 变更文件数 | [N] | 10 | OK/CROSSED ([X]x) |
| 提交数 | [N] | 5 | OK/CROSSED ([X]x) |
| console.log | [N] | 0 | OK/CROSSED |
结论:[PASSED / TRIGGER_PR - 本应更早推送 PR]
2.2 差距识别
| 要求 | 预期 | 实际 | 状态 |
|---|---|---|---|
| 会话头/尾 | 每次响应 | [数量] | Done/Missing |
| pr-review 技能格式 | 完整报告 | [格式] | Done/Partial/Missing |
| qa-commit 技能格式 | 完整标准表 | [格式] | Done/Partial/Missing |
| pr-threshold 检查 | 每次提交后 | [数量] | Done/Partial/Missing |
| 风险评估 | 计算得分 | [Done/Not] | Done/Missing |
| Storybook stories | 新组件 | [数量] | Done/Missing |
| 设计系统检查 | 新模式之前 | [Done/Not] | Done/Partial/Missing |
| 提交中的 Satisfies 字段 | 每次提交 | [数量] | Done/Missing |
| Typecheck/Lint | 提交之前 | [Done/Not] | Done/Missing |
阶段三:生成合规报告
报告结构如下:
Value Delivery Compliance Audit
PR Threshold Check
| Metric | Current | Threshold | Status |
|---|---|---|---|
| Lines of Code | [N] | 300 | [status] |
| Files Changed | [N] | 10 | [status] |
| Commits | [N] | 5 | [status] |
| console.log | [N] | 0 | [status] |
Verdict: [PASSED / TRIGGER_PR]
Gaps Identified
| Requirement | Expected | Actual | Status |
|---|---|---|---|
| [requirement] | [expected] | [actual] | [status] |
| ... |
Recommendations
[列出下次会话的改进项]
阶段四:记录到会话日志
如果使用 Notion 同步,将合规报告添加到 Session Journal 条目中。
输出格式
审计应生成与用户合规截图中所示格式一致的表,对阈值违规给出清晰的 CROSSED 指示,对差距分析给出状态图标。
集成方式
该技能由以下方式调用:
- push-pr.mdc —— PR 创建后(阶段四)。
- 手动调用用于回顾。
调用方式
PR 推送后自动调用,或手动输入“use compliance-audit skill”调用。