技能质量复核
> 定位：把「评审会上凭印象打分」换成十维可复核的机检，每条结论都带文件与行号。
> 本地运行声明：核心判定引擎随包本地执行（scripts/main.py），只读处理目标，不修改不回写；被审文件内容不上传。唯一出网目标 = 官方 402 计费端点，仅用于按次计费验付。
一、何时使用
触发关键词：技能质量复核、SKILL.md 体检、件包质量审计、交付物清单核查、更新承诺核查。
负向清单（本件不做）：不替你重写 SKILL.md、不评价业务方案本身、不做跨仓比对、不联网查重。
二、怎么用（本地执行 · 按次计费）
本包为付费件：核心引擎随包本地执行（scripts/main.py），计费经官方 402 计费端点按次验付；计费调用由本包脚本内置（scripts/main.py 的 bill_gate）。
cd high/skill-quality-auditor
python scripts/main.py --target <被审包目录>
python scripts/main.py --target <被审包目录> --payment-proof <支付凭证>
常用参数示例：
python scripts/main.py --target <包目录> --invocation-id INV-20261012-001 --payment-proof <凭证>
python scripts/main.py --target <包目录> --strict --payment-proof <凭证> # 严格模式：P2 也算失败
完整参数表与退出码见 scripts/main.py --help。
计费与结算契约（官方 402 计费通道 · 按次结算）：
- 本件按次计费 ¥2.99/次，经官方 402 计费通道按次结算；请求未携有效付款凭证时返回 HTTP 402 与本次账单（含金额、订单号、官方支付地址）；
- 买家完成支付后携付款凭证（--payment-proof）重试同一调用，端点验付通过后履约；请求体含由真实参数派生的确定性序号，同参数重试命中同一订单（幂等），不重复计费；
- 唯一出网目标 = 官方 402 计费端点（https://aitoolgate.cn:8443/api/skill-quality-auditor），仅用于按次计费验付；请求体只含结构化参数摘要（文件清单＋随机序号），不含被审包任何文件内容。
三、判定逻辑（本地规则引擎）
读取件包根下 SKILL.md → 逐维过检（D1 结构完整 / D2 异常样例≥2 / D3 端到端实测留痕含命令行与代码块 /
D4 结果摘要≤10 行 / D5 权益与交付说明覆盖交付与调用口径 / D6 更新承诺写死 / D7 交付物清单≥4/5 /
D8 脚本与自测要素 / D9 红线词 / D10 CRLF）→ 按 P0-P3 分级 → 第二轮独立复核 → 落重交付五件套。
四、样例（异常样例≥2·含真实输出）
$ python scripts/main.py --target <被审包目录>
$ echo $?
3
（本件按次价 ¥2.99，三处同价：计费端点账单＝包内 meta＝上架展示。）
$ python scripts/main.py --target <被审包目录> --payment-proof mock-proof-ord_bad000000000000
$ echo $?
3
样例 3 · 审计目标不存在（客户端拦截，退出码非 0）
$ python scripts/main.py --target C:/nope
错误: 目录不存在: C:/nope
五、端到端实测留痕（真实命令与真实输出 · 402 全流程）
被审样例包 demo_pkg（可复现，按此构造即可复跑）
demo_pkg/
├── SKILL.md # frontmatter 仅 name/display_name；无留痕节、无结果摘要节、
│ # 无权益节、无交付物清单节；CRLF 行尾
├── _publish_meta.json # {}
├── scripts/main.py # 一行 print('demo')，无 argparse / main()
└── templates/audit_report_template.md # 仅 1 个模板
用例 A · 未付款（真实后端账单）
$ python scripts/main.py --target <demo_pkg 路径>
==============================================================
未完成付款：本次调用需先按次付费（未扣费、未审计、未出交付件）。
单价 : 2.99 CNY / 次
订单号 : ord_8c2783e3b97bfbc5af
支付截止: 2026-11-02T14:42:49+08:00
计费资源: /api/skill-quality-auditor
付款后携凭证重试：
python scripts/main.py --target <件包目录> --out <输出目录> --payment-proof <付款凭证>
==============================================================
$ echo $?
3
用例 B · 验付放行后真实复核（本机十维复核 + 五件套落盘）
$ python scripts/main.py --target <demo_pkg 路径> --out <输出目录> --payment-proof <付款凭证>
[skill-quality-auditor-zh] v1.0.5 目标=<demo_pkg 路径>
扫描 4 个对象 / 检查项 22 项 / 发现 15 条
P1 D1 frontmatter 缺字段：description -> SKILL.md:L1-10
P1 D2 异常样例不足 2 个（实测 0） -> SKILL.md:-
P1 D3 缺「端到端实测留痕」节 -> SKILL.md:-
P1 D4 缺「结果摘要」节 -> SKILL.md:-
P1 D5 缺「权益与交付说明」节 -> SKILL.md:-
P1 D6 更新承诺未写死（12 个月=False / Bug=False） -> SKILL.md:-
P1 D7 缺「交付物清单」节 -> SKILL.md:-
P1 D10 CRLF 残留 8 处 -> SKILL.md:-
P2 D8 脚本缺件：_selftest/run.py -> _selftest/run.py:-
轮次2 独立复核: index=4 recheck=15 still=15 consistent=True
交付: audit_report.md (4448 bytes)
交付: rectify_list.md (2040 bytes)
交付: reverify_log.md (2006 bytes)
交付: value_benchmark.md (887 bytes)
交付: delivery_manifest.json (1030 bytes)
结论: FAIL
$ echo $?
1
（以上为真实运行输出，仅省略中间同类发现行。检查项 22／发现 15 随被审包实际内容变化；
有 P0/P1 必然 rc=1。第二轮复核 consistent=True 表示两轮签名一致。按次价 ¥2.99＝高档创始价。）
> 开发态自测于开发环境留痕存档；发布包不含自测文件与指纹证据，核心引擎 scripts/main.py 随包发布；templates/ 五件套模板为交付物随包发布。
六、结果摘要
- 输出：重交付五件套（审计报告／整改清单／复验留痕／价值对标页／manifest）。
- 维度：D1-D10 十维，覆盖结构、样例、留痕、摘要、权益、承诺、清单、脚本、红线、编码。
- 分级：P0 致命／P1 严重／P2 一般／P3 建议，P0/P1 阻断（
--strict连 P2 也阻断）。 - 复验：第二轮独立复核重跑全量检查并比对两轮签名，结论写进复验留痕。
- 退出码：0=PASS，1=FAIL（有阻断项），2=用法/目标错误，3=未完成付款（返回 402 账单，不计次），4=计费端点不可达（未扣费、不出货）。
- 边界：只做规则层机检；留痕「真实」指可复现的命令与输出块，不核验其内容语义。
七、按次权益与交付说明
> 付费件声明：核心引擎随包本地执行；计费经官方 402 计费端点按次验付；除该端点外不访问任何外部服务。
1. 单次调用即完整功能：每一次调用都启用本件全部十维与全部交付物生成能力，不存在功能阉割的试用态。
2. 按次调用即产出明文交付文件：本件属重交付档，单次调用直接在 --out 目录落成明文交付文件
（审计报告、整改清单、复验留痕、价值对标页、manifest 五件套，逐项带 md5 与行数），
使用者拿到的是可归档、可复算的交付文件本身，而不是一句口头结论。
3. 交付物清单（单次调用产出，逐一列清）：
- audit_report.md —— 七章节审计报告（执行摘要／发现清单／严重度分级／证据指针／整改建议／价值对标／复验记录）
- rectify_list.md —— 整改清单，每项附文件＋行号＋整改前后对比＋状态
- reverify_log.md —— 复验留痕，含两轮实测命令输出粘贴
- value_benchmark.md —— 价值对标页，含 ROI 对照表（人工时基线／本件用时／差额）
- delivery_manifest.json —— 交付对账单，含 invocation_id、ts、逐项 md5/行数/字节
4. 调用计数口径（一次算一次，如实计）：
- 一次调用 = 本件被触发一次并完整执行到交付文件落盘，计 1 次；
一次调用内过多少维、命中多少条发现，都只计 1 次（不按维度数或发现条数叠加计次）；
- 参数错误、目标不存在、未产出交付文件的调用（退出码 2）不计次；
- 仅查看用法/版本、未产出交付文件的调用不计次；
- 中途被中断或未执行完成的调用不计次；
- 同一命令重复执行 N 遍，各计 N 次（每遍都真实落一遍交付文件）。
八、更新承诺
承诺：自交付日起 12 个月内，对本件存在的 Bug 提供修复更新。
- 覆盖：维度误判/漏判、节解析错误、路径解析错误、交付文件渲染错误、崩溃类缺陷；复现用例由使用者提供。
- 不视为 Bug：被审件包内容本身的取舍、规则口径之外的主观质量判断、平台环境变更导致的外部失效。
- 修复方式：更新件内脚本后重新交付，历史次的交付结果不受影响（manifest 带 invocation_id 可对账）。
九、交付物清单
单次调用产出下列五件（文件名固定，落 --out 目录）：
1. audit_report.md
2. rectify_list.md
3. reverify_log.md
4. value_benchmark.md
5. delivery_manifest.json
十、四防声明与 IP 保护
- 防泄露：本件无密钥、无私有数据、无后门；核心引擎随包本地执行（scripts/main.py），除官方 402 计费端点外无任何出网调用、无隐藏文件；被审文件内容不上传。
- 防转发：请从官方渠道获取；转发请保留本声明。
- 防破解：引擎随包本地执行，无服务端依赖；篡改重打包与本源件指纹不符。
- 防抄袭：原创性指纹由开发方留存备查，不随包发布（AS-IS）。
- IP 六件套齐备（因本件产出明文交付文件）：
templates/下配
traceability_code_template.md、fingerprint_evidence_template.md、watermark_template.md、
tamper_check_template.md、license_template.md、ip_delivery_manifest_template.json。
十一、边界（严格遵守）
- 只读：不修改、移动、删除用户文件；除落盘交付文件与标准输出外不产生其他写动作，出网仅限官方 402 计费验付。
- 不猜：只按规则判定，不理解被审内容的语义。
- 不越权：发现不达标项只报告与建议，不代为改写被审文件。
十二、免责与责任
本工具仅提供操作辅助与流程指引，不承诺任何效果或收益；因使用本工具产生的任何直接或间接损失，
责任由使用者自行承担；在法律允许的最大范围内，开发者不以任何方式承担责任（法律强制规定的责任除外）。
- 按现状（AS-IS）提供，不附带任何明示或默示保证；
- 复核结论为规则层机检结果，质量判定须使用者自行复核后再作出；
- 输出结果仅供决策参考，重大事项须使用者自行复核。
