# Repro Pack · 快速入门

> 社区开源 skill，非 the AI provider 官方产物。
> 许可：MIT · 仓库：https://github.com/mshs01156/support-to-repro-pack
> 整理：Ameureka × CCAF101（独立中文学习社区，并非认证方官网）

> ⚠️ **名称变体/场景不同**，非原版。详见下方"能力边界"。

## 一句话定位

一键把客服工单脱敏打包成研发可直接开工的可复现问题包——Python 正则保可靠，AI 补语义。

## 核心能力

客服工单→研发可复现问题包的桥接 Agent：把杂乱的客服材料（工单、日志、截图、聊天记录）自动脱敏、解析、抽取事实，输出研发可立即开工的标准化问题包。Python 正则负责确定性脱敏/解析/提取，the AI 负责语义推理（根因假设、复现步骤、严重等级）。

## 关键特性

- PII 脱敏引擎 — 17 种隐私正则模式：邮箱、手机号（中美英）、IP、信用卡、身份证、社保号、AWS 密钥、JWT、Stripe 密钥、密码、含凭证 URL、Cookie、UUID、私钥、Bearer Token、API Key
- 日志解析 — 自动识别 JSON / syslog / 纯文本，提取时间戳、日志级别、来源
- 堆栈提取 — 支持 Python、Java、JavaScript/Node.js、Go 四种语言
- 事实抽取 — 版本号、AWS 区域、功能开关、错误码（HTTP/应用/gRPC 分类）、User-Agent、URL
- 事件时间线重建 + AI 语义补漏（漏网 PII、矛盾检测、缺失信息、根因假设、P0-P4 严重等级）
- 一键输出 8 个标准化文件：脱敏工单/日志、facts.json、timeline.json、工程 Issue、内部升级摘要、客户回复、脱敏审计报告
- 中英双语：中文工单出中文结果，英文工单出英文结果

## 安装

两步安装。1) Python 后端：克隆仓库后 `pip install -e ".[dev]"`（需 Python≥3.10，依赖仅 click≥8.1 与 jinja2≥3.1），验证 `repro-pack --version`。2) AI Code Assistant 技能层：把仓库内的 `.claude/skills/support-to-repro-pack/` 目录复制到你项目的 `.claude/skills/`（或 `~/.codex/skills`、`.agents/skills`）下；SKILL.md 的 Prerequisites 要求环境内已 `pip install -e /path/to/support-to-repro-pack`，使 the AI 能通过 `python -m repro_pack ...` 调用 CLI 子命令（redact/parse/extract/timeline/traces/run）。

## 使用流程

1. 收集输入材料：客服工单/bug 报告、日志文件、截图图片路径、聊天记录等
2. 图片预处理：the AI 读取截图提取可见文字（错误信息、URL、状态码、UI 标签）写入文本文件
3. 运行确定性处理：依次跑 redact（脱敏）、parse（日志解析）、extract（事实抽取）、timeline（时间线）、traces（堆栈）、redact --audit（脱敏审计）
4. AI 语义分析：正则漏网 PII 补漏、对照 reproduction-checklist.md 检测缺失信息、检测事实矛盾、生成最小复现步骤、按 severity-matrix.md 评 P0-P4、给根因假设
5. 生成三份文档：engineering_issue.md（研发）、internal_escalation.md（PM/主管）、customer_reply.md（客户，绝不含内部细节）
6. 打包输出：`repro-pack run --ticket ... --logs ... --outdir ... --zip` 生成 8 个文件并覆写 AI 审核后的版本，最后给出文件清单、关键发现与警告

## 适用人群

客服/技术支持团队、研发工程师、技术主管/PM、合规与安全人员——任何需要把含隐私的客户 bug 工单安全、结构化地交接给研发团队的组织。

## 示例 Prompt

```text
把这个工单变成研发 issue（或：脱敏这些日志并生成复现步骤）
```

## 能力边界（诚实说明）

本工具是"工程问题复现包（engineering repro pack）"工具，面向客服→研发的 bug 工单交接与 PII 脱敏场景，并非论文实验复现工具；虽名称含 "repro"，但与论文复现无直接关系。论文复现场景可参考 02 的 reproducibility_protocol.md。原仓库作者为 mshs01156，与 CCAF101 无任何官方关系，此处仅作能力相近的可参考实现展示。仓库为单一 skill（非套件），内含 references/（pii-redaction-rules.md、reproduction-checklist.md、severity-matrix.md）与 templates/（engineering_issue.md、internal_escalation.md、customer_reply.md）辅助文档。

## 完整源码

见 https://github.com/mshs01156/support-to-repro-pack（本文件为 CCAF101 编辑整理的快速入门，非完整仓库镜像）。

---

Ameureka × CCAF101 · 独立中文学习社区，并非认证方官网。文中第三方产品名为其各自厂商商标，CCAF101 不与之关联且不暗示使用关系。