Skill 成熟度与新 Chat 验证

沿原课件保留 L0–L4 作为团队自评工具：L0 Chat 完成任务：单次对话内完成任务，结果可用；L1 Instruction Skill：通过清晰指令，在新 Chat 中复用；L2 Structured Skill：具备结构化输入输出、参数控制和稳定执行流程；L3 Verified Skill：具备结果验证机制，能识别错误并正确停止；L4 Team-ready Skill：可在团队中规模化使用，具备文档、监控和持续优化机制。它是教学成熟度模型，不是官方认证等级。

第 6 页目录中的 inspect.py、transform.py、validate.py 是职责示例。下载练习包把输入检查、处理和结果验证合并在 pipeline.py 中执行；目录结构可按任务规模调整。

数据处理应逐步具备确定性处理与结果核验。简单文案 Skill 不需要为追求等级增加脚本或空目录。

返回第 7 页

按需阅读

把第一件小事做成 Skill

先验证一个小任务，有需要时再增加工程细节。

练习包里有什么

练习使用虚构的 JSON 工单明细，避免安装 Excel 处理库。它演示的去重、统计和校验方法也适用于表格任务，真实 Excel 接入需另行实现字段读取。

下载练习包 ZIP 下载可导入的 Skill ZIP

practice-kit/
  ticket-daily-report/
    SKILL.md
    references/data-contract.md
    references/business-rules.md
    scripts/pipeline.py
  fixtures/   正常、变更和异常输入
  expected/   独立预期结果
  GUIDE.txt   操作方法与验证记录模板

Python 3.9+，只用标准库。Skill ZIP 只包含能力目录，练习数据在完整练习包中。这里没有空 assets/，因为练习不需要模板。

python3 ticket-daily-report/scripts/pipeline.py \
  --input fixtures/normal.json --date 2026-10-10 --out result-first

输出目录须不存在。通过后生成 report.json、report.txt、evidence.json。预期为 5 单，完成 3 单、待处理 2 单，完成单平均耗时 65 分钟。缺字段或重复 ID 内容冲突时停止，并且不创建成功结果。

给 Qoder 的练习提示词

请使用 ticket-daily-report Skill，对练习包 fixtures/normal.json 生成日报。统计日期为 2026-10-10，输出到一个新的结果目录。先读取数据契约与业务规则，再运行 scripts/pipeline.py。校验失败时停止并说明原因，校验通过后交付日报和 evidence.json。我会用 expected/2026-10-10.json 核对结果。

怎样在 Qoder 中加载

当前 Qoder：在扩展的技能页中添加技能，导入完整 Skill ZIP，确认出现在已安装中。新建任务，输入 / 选择 Skill，再提供练习数据、日期和输出位置。菜单名称可能随版本变化。

QoderWork 的官方本地目录为 ~/.qoderwork/skills/。Qoder CLI 的用户级目录为 ~/.qoder/skills/，项目级目录为 .qoder/skills/。这些产品的加载方式分别验证，不能只复制到一个目录就宣称全端可用。

Qoder 指南 · QoderWork 指南 · CLI 指南

让 Qoder 从成功任务中提炼 Skill

请把刚才成功完成的工单日报任务提炼成一个可复用 Skill。写清何时使用、必需输入、统计口径、输出和停止条件。入口放 SKILL.md，详细规则放 references/，把已经验证的关键数据处理保存到 scripts/。不要创建用不到的空目录。不要依赖这次聊天历史，也不要编造缺失口径。提供正常、变更、异常三类验证样例，我会在新 Chat 中测试。

三次测试，各看什么

场景	输入	应有结果
正常	normal.json，10 月 10 日	与 expected/2026-10-10.json 一致，留校验记录
变化	changed.json，10 月 11 日	字段重排和无关字段不影响结果，完成 1 单，平均 30 分钟
异常	missing-field.json 或 conflicting-id.json	停止，指出缺口，不生成成功报表

每次开全新 Chat。先手动选择 Skill 验证执行，再用自然语言验证触发。最后请另一位同事使用同版本再试。记录产品与版本、Skill 版本、是否找到、实际脚本、校验结果和文件位置。

本练习的脚本已经按确定性案例检查。你自己的 Qoder 是否导入成功、正确选中 Skill 并按流程停止，需要在你的环境验证。

什么时候需要更多目录

tests/ 保存程序测试，例如去重、日期边界和舍入的预期结果。evals/ 保存 Agent 场景，例如新 Chat 的发现、执行和异常处理。它们是可选团队扩展，目录存在不会自动运行。业务口径集中在 references/，实现放 scripts/。简单的文字 Skill 可以只保留 SKILL.md。

把版本、输入文件摘要、处理计数和校验结果留在运行记录中，可以比较改动前后发生了什么。没有实测，不写节省百分比，也不把一次通过当成长期稳定。

常见问题

一定要会 Python 吗？

不需要。你负责说明业务口径、正确结果和异常情况。让 Qoder 或技术同事将容易出错的重复计算保存成脚本，再一起核验。

原 Chat 成功，新 Chat 找不到 Skill？

先确认安装，再输入 / 查找。手动运行成功但自然语言找不到，先改进 description 的任务与触发说明。不要同时把发现失败当成计算错误。

为什么有了脚本还要核验？

脚本也可能使用错误口径或漏掉边界。用独立预期结果和异常案例核对，再检查 Agent 有没有实际调用脚本、有没有跳过校验。

可以直接用真实客户数据吗？

先沿用项目的数据权限与处理约定。教程与练习数据可以公开分享，不能据此推断所有业务输入也能上传。

问题反馈

遇到问题，请联系张坚、李琦。附上脱敏输入样例、预期结果和出错截图。

复制反馈模板

问题反馈给张坚、李琦
使用的 Skill 和版本：
期望得到什么：
实际发生什么：
使用的产品和版本：
附件：脱敏输入样例、出错截图、校验记录
请先移除客户信息、账号和密钥。

依据与边界

文件结构依据 Agent Skills 规范，Qoder 操作参考其官方指南。目录扩展、三类测试和执行证据是本教材的工程建议。阅读时长为估计，未声称已验证效率收益。

内容更新：2026-10-12。浏览器课件、PPTX、PDF 的 9 页核心内容来自同一份内容源。