Replay2Skill Forge（回放成技）

把一次已成功、被纠正并验收的 Agent 任务证据包，编译成可审阅、可测试、可跨宿主预览/导出的本地 Agent Skills 包。

本 Skill 是参赛发布的 Replay2Skill 本体（canonical），不是 merge-sales-workbook 等由本工具生成的示例派生 Skill。

When to use（触发条件）

在用户出现以下意图时使用本 Skill：

将一次成功任务的证据包「回放成技」/ 编译为可复用 Skill 预览
对任务证据做结构校验、秘密/PII/绝对路径脱敏审阅
在已脱敏 PFSM 上可选调用本地 OpenVINO 润色描述（非执行结构）
将已校验 Skill 预览导出到项目本地宿主目录（WorkBuddy / Qoder / TRAE）
显式要求对 2–20 份已脱敏且成员同意导入的证据包做团队共识/冲突报告（辅线）

不要在以下情况使用：

用户要求静默覆盖已安装 Skill、自动发布、后台采集聊天库、API 拦截
未提供证据包路径、或证据仍含未脱敏敏感生产数据且用户拒绝脱敏
将本地 OpenVINO 结果当作结构/安全门禁的唯一权威

个人默认流程（primary）

所有命令在仓库根目录执行，且依赖仓库现有 CLI（不复制业务逻辑）：

# 1) 编译个人证据包 → Skill 预览（确定性，默认可复现）
PYTHONPATH=src python3 -m replay2skill compile \
  --bundle <path-to-task-bundle> \
  --output <explicit-output-dir> \
  --mode deterministic

# 2) 校验生成包
PYTHONPATH=src python3 -m replay2skill validate-skill <skill-dir>

# 3) 导出到项目本地宿主目录（默认仅预览；--apply 才写入）
PYTHONPATH=src python3 -m replay2skill export-host \
  --skill <validated-skill-dir> \
  --project-root <project-root> \
  --host workbuddy \
  --format markdown

可选：包装脚本（标准库，无联网）做环境/路径自检：

python3 skills/replay2skill-forge/scripts/doctor.py
python3 skills/replay2skill-forge/scripts/r2s_wrap.py compile -- --bundle ... --output ... --mode deterministic

流水线语义（权威实现在 src/replay2skill/）：

加载并结构校验证据包（task.json 等）
秘密 / PII / 绝对路径脱敏 → 占位符（报告不含原文片段）
宿主中立动作归一化 → PFSM
可选 OpenVINO 仅润色五类非执行文本字段
模型输出后再次结构脱敏
写出 Skill 预览 + 报告；输出路径拒绝隐式覆盖
validate-skill 与安全探针为权威门禁

团队显式 opt-in 流程（secondary）

仅当用户明确要求团队聚合，并提供 2–20 个显式路径的已脱敏包时：

PYTHONPATH=src python3 -m replay2skill team-compile \
  --bundles <bundle1> <bundle2> [...] \
  --output <explicit-output-dir> \
  --mode deterministic \
  --alias <slug1> --alias <slug2>

规则：

成员别名须为匿名 ASCII slug；冲突保持 unresolved，不静默覆盖
可选 --approve 映射仅在操作者显式提供时解决冲突
共识/冲突/来源写入共享 Skill 的 references/team-*.json
团队不得升级为默认路径或多人协作平台

输入：证据包（task bundle）

最小输入目录示例：

task-bundle/
  task.json          # 必填：goal、description、success_criteria 等
  trace.jsonl        # 可选：动作轨迹
  feedback.json      # 可选：用户纠正与验收

合成样例见仓库 fixtures/personal/task_a/。字段约定见 references/input-bundle.md。

Preview-first 与人工批准边界

| 动作 | 默认 | 写入条件 | | --- | --- | --- | | compile / team-compile | 仅生成预览目录 + 报告 | 输出目录与报告路径必须尚不存在 | | validate-skill | 只读校验 | 无写入 | | export-host | 预览导出计划 | 仅 --apply 时事务性写入项目本地 skill 目录 | | 覆盖已安装 Skill / 发布 | 禁止自动 | 仅人工确认后的宿主侧操作 |

生成或合并结果在人工批准前不是已安装生产 Skill。

脱敏审阅

生产脱敏使用作用域占位符（如 R2S_...）；报告只保留 kind/count，不保留密钥片段
禁止把真实用户绝对路径、密钥、PII 写入 Skill 包或提交材料
审阅 references/redaction-report.json（计数与 kind）后再决定是否导出

详见 references/privacy-boundary.md 与仓库 docs/SECURITY.md。

OpenVINO 模式（advisory）

PYTHONPATH=src python3 -m replay2skill compile \
  --bundle <path-to-task-bundle> \
  --output <explicit-output-dir> \
  --mode openvino \
  --model-dir <local-OpenVINO-Qwen3-4B-int4-ov-dir>

约束：

仅本地目录模型；运行时不从云端/HF 下载
仅在已脱敏 PFSM 上润色描述/步骤摘要等文本；不改步骤顺序、工具、批准门
失败必须显式报错；禁止静默回退到 deterministic 却报告 openvino 成功
schema / 安全 / 路径 / validate-skill 始终权威

校验与验收

包内最小验收：

doctor.py 退出码 0（仓库布局与 CLI 可导入）
对合成 fixture 跑通 compile + validate-skill
全仓：unittest、self_check、RED/GREEN/real-sink 安全探针（见 references/acceptance.md）

项目本地宿主导出

| --host | 项目内目标路径 | | --- | --- | | workbuddy | .codebuddy/skills/<name>/ | | qoder | .qoder/skills/<name>/ | | trae | .trae/skills/<name>/ |

当前证据：WorkBuddy 5.1.5 对示例包有发现/加载/描述摘要；Qoder/TRAE 仅静态路径兼容，未宣称运行时实测。详见仓库 docs/HOST_INTEGRATION.md。

安全硬边界（摘要）

不复制第二套核心实现；只调用 python -m replay2skill
无联网脚本；失败显式非 0；无伪成功、无静默 fallback
不读取宿主私有聊天库；不自动发布；仓库与发布包采用 MIT（见根级 LICENSE）
派生示例 Skill（如 merge-sales-workbook）不是本参赛本体

References

references/input-bundle.md — 证据包格式
references/cli-commands.md — 权威 CLI 命令
references/privacy-boundary.md — 隐私与 Hybrid AI 边界
references/acceptance.md — 验收条件
仓库文档：README.md、docs/SECURITY.md、docs/LOCAL_MODEL.md、docs/HOST_INTEGRATION.md