Skill Engineering 自学课件 01 / 09

为什么需要 Skill Engineering

让一次成功的任务,沉淀为可复用、可验证、可迭代的团队能力

当前现象

已经开始使用 Qoder

不少同事已把 AI 用到日常工作中

数据处理是主要场景

整理明细、汇总报表、解释结果

主要仍通过 Chat 完成工作

每次重新说明需求,再反复调整

成功经验尚未稳定沉淀

换一个 Chat,往往又要从头解释

下一步目标

感知 Skill 的作用

看见流程和规则复用带来的价值

一次性完成成为可复用能力

把成功方法留在完整的能力包中

个人经验成为团队共同方法

让另一位同事也能按同一口径完成

形成共同的工程语言

知道如何设计、执行、验证和改进

把 Chat 中成功的方法沉淀为 Skill,再通过验证与复用完善它。

出品:AI 经营交付效能专项组从 Chat 使用者,到 Skill 工程实践者

Skill Engineering 自学课件 02 / 09

从一次数据处理任务说起

拿到下面这份工单明细,怎样让 AI 把它整理成 10 月 10 日的日报?

输入:7 行虚构工单明细

工单 ID创建日期状态耗时 / 分钟
T0012026-10-10已完成60
T0022026-10-10待处理0
T0032026-10-10已完成45
T0042026-10-10已完成90
T0042026-10-10已完成90
T0052026-10-10待处理0
T0062026-10-11已完成30

T004 重复一行;T006 属于 10 月 11 日。 下载工单练习包

交给 AI 的任务

请统计 10 月 10 日创建的工单,按 ID 去重;内容冲突时停止。告诉我总数、完成数、待处理数,以及完成工单的平均耗时。

应该交回的日报

5 单:完成 3 单,待处理 2 单

完成单平均:(60 + 45 + 90) ÷ 3 = 65 分钟

这份明细要变成一份日报:去重、按创建日期筛选,再统计数量与完成单平均耗时。

出品:AI 经营交付效能专项组从 Chat 使用者,到 Skill 工程实践者

Skill Engineering 自学课件 03 / 09

Chat、Skill、Skill Engineering

把一次成功的任务,转化成能跨对话复用、执行关键操作、具备验证机制的工作能力。

核心公式

Skill Engineering = Skill Design + Deterministic Execution + Validation + Evaluation + Reuse

Skill Design技能设计Deterministic Execution确定性执行Validation结果验证Evaluation效果评估Reuse复用传播
01

Chat 使用

单次完成任务

提出问题,获得答案
解决当下的任务

02

Skill 使用

复用已有能力

调用已沉淀的流程和资源
按约定方法完成任务

03

Skill Engineering

工程化沉淀与持续优化

分清规则、实现与验证
换对话、换数据、换人复用

更稳定:新 Chat 也能复现。更可靠:关键计算可验证。更高效:团队可复用、可传播。

出品:AI 经营交付效能专项组从 Chat 使用者,到 Skill 工程实践者

Skill Engineering 自学课件 04 / 09

一个数据处理 Skill 的两个部分

Workflow 安排任务怎样推进,Data Processing 完成数据的解析、转换与计算。

Workflow:任务怎样推进

01

理解任务

确认目标与业务规则

02

检查输入

核对字段、类型、日期

03

执行处理

筛选、关联、去重、汇总

04

验证结果

每次核对,失败停止

05

分析交付

解释结果并交付报表

Workflow(工作流)

决定步骤顺序、如何处理歧义、何时继续、何时停止。

Data Processing(数据处理)

按确认的规则完成运算,并返回结果、异常与校验信息。

Workflow 安排执行与停止;每次运行通过结果校验后,再分析交付。

出品:AI 经营交付效能专项组从 Chat 使用者,到 Skill 工程实践者

Skill Engineering 自学课件 05 / 09

AI 推理 vs 确定性执行

在工作流与数据处理两个层次上,分别确定 AI 和固定代码的职责。

工作层次AI 推理负责确定性实现负责
Workflow
工作流
识别任务意图
判断异常原因
选择处理策略
固定步骤顺序
状态检查
必经校验、停止条件
Data Processing
数据处理
理解字段含义
识别非标准格式
解释异常
筛选、关联、去重
汇总、金额计算
格式验证

让 Agent 处理不确定性,让代码处理确定性,让验证机制决定结果是否可信。

出品:AI 经营交付效能专项组从 Chat 使用者,到 Skill 工程实践者

Skill Engineering 自学课件 06 / 09

一个好的 Skill 长什么样

SKILL.md 保留入口与行为契约,详细 Spec 与 Implementation 按职责分开。

ticket-daily-report/
01

SKILL.md

执行入口与行为契约

何时使用
执行路径与分支
完成与停止条件

02

references/

业务与技术 Spec

data-contract.md
business-rules.md
workflow-spec.md

03

scripts/

确定性实现

输入检查 inspect.py
数据处理 transform.py
结果验证 validate.py

04

assets/

模板与静态资源

报表模板
实际需要的图片
其他输出资源

按需扩展:tests/ 验证程序,evals/ 验证 Agent 的完整行为。

主文件简洁,细节按需加载(Progressive Disclosure)。简单任务可以只有 SKILL.md。

出品:AI 经营交付效能专项组从 Chat 使用者,到 Skill 工程实践者

Skill Engineering 自学课件 07 / 09

Qoder 实操:沉淀一个 Skill

以已经做对的工单日报为起点,把任务方法整理成能独立执行的能力包。

01

成功任务

保存输入、口径
和核对过的结果

02

提炼 Skill

写清契约与流程
保存关键处理脚本

03

导入完整包

在技能管理中导入 ZIP
确认出现在已安装中

04

新 Chat 运行

用 / 选择 Skill
只给本次必要输入

给 Qoder 的提示词:把刚才成功的数据处理沉淀为 Skill:保存输入、口径和验收结果,写清流程与停止条件;关键处理与校验保存为脚本;新 Chat 不依赖旧历史。

先手动选择验证执行,再用自然语言验证触发。Qoder 操作入口按当前产品版本核对。

出品:AI 经营交付效能专项组从 Chat 使用者,到 Skill 工程实践者
下载工单练习包
完整的 Skill 创建提示词
请把刚才成功完成的工单日报任务提炼成一个可复用 Skill。写清何时使用、必需输入、统计口径、输出和停止条件。入口放 SKILL.md,详细规则放 references/,把已经验证的关键数据处理保存到 scripts/。不要创建用不到的空目录。不要依赖这次聊天历史,也不要编造缺失口径。同时保存一份输入、确认的业务口径和核对过的结果;提供正常、变化、异常三类验证样例,我会在新 Chat 中测试。
使用练习包运行
请使用 ticket-daily-report Skill,对练习包 fixtures/normal.json 生成日报。统计日期为 2026-10-10,输出到一个新的结果目录。先读取数据契约与业务规则,再运行 scripts/pipeline.py。校验失败时停止并说明原因,校验通过后交付日报和 evidence.json。我会用 expected/2026-10-10.json 核对结果。

Skill Engineering 自学课件 08 / 09

如何证明 Skill 可靠

自评帮助发现缺口;实际用例核对发现、执行、结果与停止行为。

01

Discovery

能否找到正确的 Skill

新 Chat 中手动选择
再测试自然语言触发

02

Execution

能否独立完成任务

不依赖历史聊天
按契约调用已有脚本

03

Verification

能否证明结果正确

每次核对关键结果
校验失败时明确停止

正常输入结果与独立预期一致
可处理的变化变化后仍按规则处理
应停止的异常异常停止,无成功产物

程序 Tests 核对结果;Agent Evals 检查实际选择、执行与停止。修改后重跑,再请同事用同版本验证。

出品:AI 经营交付效能专项组从 Chat 使用者,到 Skill 工程实践者

Skill Engineering 自学课件 09 / 09

开始实践与问题反馈

把日常工作中的一个成功方法,变成下一次可以继续使用的 Skill。

今天就可以开始的一次实践

01

选任务并自评

规则清楚,先确认验收依据

02

完成三类验证

正常、变化、异常,核对结果与停止

03

换人复用并迭代

同版本再试,把新问题补进用例

业务同事沉淀方法与验收标准,技术同事协助固定关键处理,团队共同验证和改进。

出品:AI 经营交付效能专项组从 Chat 使用者,到 Skill 工程实践者
下载练习包自评自己的 Skill
问题反馈模板
问题反馈给张坚、李琦
使用的 Skill 和版本:
期望得到什么:
实际发生什么:
使用的产品和版本:
附件:脱敏输入样例、出错截图、校验记录
请先移除客户信息、账号和密钥。