工单日报参考练习包（课程 v2.5，Skill 本身 v1.0）
AI 经营交付效能专项组

全部数据为教学虚构数据。Python 3.9+，不需要第三方依赖。
本版统一目录；处理脚本、业务口径和已确认答案保持原样。

ticket-daily-report/
  SKILL.md                       使用说明
  references/                    业务规则与数据契约
  scripts/pipeline.py            处理脚本
  tests/check-regression.py      程序测试
  tests/fixtures/                输入样例
  tests/expected/                已确认的正确答案
  tests/example-results/         历史失败与修复记录
  evals/evals.json               AI 任务提示、输入与判定标准
  evals/README.txt               在 Qoder 中逐案执行的方法

安装与运行：
1. 检查说明和脚本，再将 ticket-daily-report.zip 导入 Qoder 的技能管理。
   完整参考包用于阅读和对照，现成 Skill ZIP 用于导入。
   Qoder、QoderWork、IDE、CLI 的加载入口按当前产品指南核对：
   https://docs.qoder.com/zh/qoder/skills
   https://docs.qoder.com/zh/qoderwork/skills
   https://docs.qoder.com/zh/cli/Skills

2. 新建一个验证文件夹，将 tests/fixtures/normal.json 复制进去。
   开全新 Chat，选择验证文件夹，用 / 选择 ticket-daily-report，然后说：
   用 normal.json 生成 2026-10-10 的工单日报，保存到新的 ticket-reference-run 文件夹。
   查看执行记录，确认实际调用的是已安装 Skill 中的处理脚本。

3. 查看 report.json，与 tests/expected/2026-10-10.json 核对。
   应有 5 单、完成 3 单、待处理 2 单、完成总耗时 195 分钟、平均 65 分钟。
   evidence.json 应为 validation=PASS，输入 7 条、重复剔除 1 条、跨日期剔除 1 条。
   统计的是指定日期创建工单的当前状态，不是当日完成量。

4. 更多任务按 evals/README.txt 执行。evals.json 的四案包括正常、变化、
   缺字段与同一 ID 内容冲突。每案开新 Chat，使用新的结果目录。
   未运行的项目保持 UNKNOWN；当前没有自动评估程序。
   可以另开评审 Chat，把 evals.json、可信答案、实际文件和执行记录交给 LLM 核对；
   材料准备与短请求见 evals/README.txt。

技术同事：在解压后的 ticket-daily-report 文件夹中运行

单案直接检查：
python3 scripts/pipeline.py --input tests/fixtures/normal.json --date 2026-10-10 --out ../ticket-first-run

四案程序测试：
python3 tests/check-regression.py --out ../ticket-regression-first

输出目录放在 Skill 包外且必须尚不存在。打开 regression.json 查看每案预期、实际、差异与退出码。
程序测试和 AI 任务评估共用 tests/ 的输入与答案，执行记录分别留存。
答案依据见 tests/expected/README.txt；不能把当前输出自动当作正确标准。
历史教学记录见 tests/example-results/：错误副本曾输出 39 而非 65，修复后四案通过。
这些记录仅证明当时的脚本检查，不证明 Qoder 行为或另一台机器通过。

验证记录（自行填写，保存在包外）：
产品与版本、Skill 版本、案例与日期、实际脚本与退出码、输出位置、预期与实际差异、
每项 PASS / FAIL / UNKNOWN、失败原因与证据。看不到或未测的耗时、Token 保持未提供。

遇到问题，请联系张坚、李琦，附脱敏输入样例、预期结果和出错截图。
本包不会联网、发送消息或写回业务系统。
