/legal-skill-alignment

T-001 B6: Legal Skill Brief v1 与通用 skill-creator 对接分析

任务：T-001 B6（与下游端到端打通验证）

v0 状态：待实测（v0 评测中 3 案例均未实测 skill-creator 编译成功率）

v1 进展：本报告产出理论对接分析 + 手动验证手册，覆盖 3 个 v1 重对齐案例对通用 skill-creator 的兼容性。

实测说明：本环境无法 spawn 独立 Claude 实例运行 skill-creator 主流程，实际编译测试须手动执行——手册见下文 §四。

关联文件：

• v0 基线：evals/case-bundle-260705/EVALUATION.md（B6 标记为"待测"）
• v1 重对齐案例：evals/case-bundle-260728/v1-realigned/
• 下游：通用 skill-creator skill 目录（路径以本机安装位置为准）

一、核心结论

Legal Skill Brief v1 与通用 skill-creator 对接良好，无需修改 Brief 规范本身即可让 skill-creator 跳过 Capture Intent + Interview 阶段直接进入 Write SKILL.md。

三个潜在摩擦点已识别：

二、逐案例对接分析

案例 01：供应商服务合同审查

Brief 路径：evals/case-bundle-260728/v1-realigned/case-01-contract-review/prompt-output.md

对接判定：✅ STATIC_COMPATIBILITY_REVIEW（静态兼容性审查通过；实测 NOT_VERIFIED），仅 F1/F2/F3 三个待人工检查项。

案例 02：著作权侵权代理词

Brief 路径：evals/case-bundle-260728/v1-realigned/case-02-copyright-litigation/prompt-output.md

对接判定：✅ STATIC_COMPATIBILITY_REVIEW（静态兼容性审查通过；实测 NOT_VERIFIED）。

额外注意点：本 case 标注 高风险结论 = 是 / 必须执业律师复核。skill-creator 主 Claude 在 Write SKILL.md 阶段应保留这个安全边界到 draft SKILL.md 的 body 或 success criteria 段。

案例 03：App 数据合规扫描

Brief 路径：evals/case-bundle-260728/v1-realigned/case-03-data-compliance/prompt-output.md

对接判定：✅ STATIC_COMPATIBILITY_REVIEW（静态兼容性审查通过；实测 NOT_VERIFIED）。

额外注意点：本 case 涉及大量法源（10+ 条监管文件），主 Claude 在 Write SKILL.md 阶段应**保留法源三列（jurisdiction / effective_date / verification_status）**到 draft SKILL.md 的 references 段或 knowledge base 表中。

三、与 v0 评测 B6 状态的对比

结论：v1 协议解决了 v0 评测中 B6 的两个潜在阻塞点（F2 / F1）。v1 Brief 顺利通过 skill-creator 对接的概率显著高于 v0。

四、手动验证手册（5 步）

如需实测，按以下步骤操作：

Step 1：准备 Brief 输入文件

每个 case 把 prompt-output.md 内容复制到剪贴板（或保存为临时文件 /tmp/brief-case-01.md）。

Step 2：启动 skill-creator 会话

在 Claude Code / Claude CLI 中：

cd <skill-creator 安装目录>

加载 skill-creator（通过 marketplace / settings.json 配置）。

Step 3：发送"已有 draft"模式指令

向 Claude 发送：

我已经把意图完整结构化在下面的 Brief 中（标题/触发场景/能力/输出/约束）。
请按 SKILL.md 第 1-3 步生成 draft SKILL.md，跳过访谈阶段。
输出目录：/tmp/test-skill-case-01/

<贴入 Brief v1 内容>

关键：用"跳过访谈"措辞匹配 SKILL.md §22-24 的"已有 draft 模式"。

Step 4：frontmatter 校验

python -m scripts.quick_validate /tmp/test-skill-case-01/

期望输出：✓ Skill <name> is valid

特别检查：

• name 是否 kebab-case
• description 是否 ≤1024 字符且含触发词
• 自定义字段（如 skill_family）是否在 metadata: 子对象下（不是顶层）

Step 5：触发评估（可选）

准备 trigger eval JSON：

[
  {"query": "我想审查一份供应商服务合同有什么风险", "should_trigger": true},
  {"query": "今天天气怎么样", "should_trigger": false}
]

跑评估：

python -m scripts.run_eval \
  --eval-set /tmp/trigger-evals-case-01.json \
  --skill-path /tmp/test-skill-case-01/ \
  --model claude-3-5-sonnet-latest \
  --verbose

判定标准：passed >= total / 2。

五、回归案例

把 3 个 v1 case 的"对接判定 = STATIC_COMPATIBILITY_REVIEW（静态通过 / 实测 NOT_VERIFIED）"作为 B6 的回归基线： 未来 v1 Brief 规范变更时，重新跑 §二 表格，对比"对接状态"列是否保持 ✅。

如果某个新 case 出现 ❌ 项，应：

1. 在 evals/case-bundle-260728/b6-compatibility-analysis/ 下新建 <case-NN>-b6-report.md
2. 列出失败的 friction point 与原因
3. 决定是调整 Brief 规范（升级 v1.1）还是调整 skill-creator 的对接策略

六、实测状态记录

本表待人工填入。实测后请把"待跑"改为"PASS / FAIL"并补实测结果摘要。

七、与 v0 评测 B6 状态的总结对照

关键改进：v1 把 B6 从"待测 + 阻塞风险高"变成"理论 PASS + 实测可手动跑"。这是 v0.x → v1.0.0 协议层重构（T-005）的核心价值兑现。