Files

T

smart 67837df8d0 docs: 更新TRA编程培训课程材料、课件与AI技能交付包

- 新增全套考试卷、评估卷、参考答案与考试培训包模板
- 修正slidev培训课件：调整模块标题、链路图缩放，替换工单示例为通用业务对象
- 修正课堂红线表述为证据红线，将小组作业调整为个人作业要求
- 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块
- 整理AI工程技能交付包，迁移旧资产至客户专属交付包并统一术语
- 新增考试输出模板与TRAE使用记录文档

2026-08-08 11:00:36 +08:00

7.9 KiB

Raw Permalink Blame History

模块 10：自定义 Agent 如何调用 Skill

一个成熟的 Agent 不把所有知识写进自己身上。

它负责选择合适的工作流、加载必要资产，并将结果交给下一步；Skill 继续负责具体任务的判断顺序和交付格式。

自定义 Agent（角色 + 工具边界）
        -> 选择 Skill（任务工作流）
        -> 加载 Rule / 任务上下文契约 / Checklist / Example
        -> 输出结构化结论
        -> 交给 Review、PR 或下一项任务

Agent、Skill 与 MCP 的本质区别

对象	本质	负责什么	不负责什么
Agent	执行角色与权限边界	选择任务、调用 Skill 和工具、控制停止与交接	承载全部业务流程与项目事实
Skill	可复用的任务工作流	规定输入、判断步骤、输出与验收	决定谁可调用、拥有什么工具权限
MCP	外部能力接口	提供查询、读取、写入等工具能力	判断业务规则、决定任务流程

谁来做：Agent

如何做：Skill

能调用什么：MCP

不同信息应该放在哪里？

信息类型	最合适的位置	原因
“先取证，缺口必须暴露”	Rule / Agent 默认指令	多个任务都必须遵守
“状态变更如何审查”	Skill	需要多步判断与停止条件
“影响分析报告长什么样”	任务上下文契约 / Template	下游需要固定结构
“五项不可遗漏检查”	Checklist	适合逐项核对
“数据库 NOT NULL 不适用的条件”	Example / 反例	防止机械套用
某项目的路径、字段和日志	运行时输入	换任务或换项目会变化

一份内容只应有一个权威位置；重复复制到 Agent、Skill 和任务上下文契约中，更新时一定会漂移。

上下文分层：稳定、任务与事实

层级	内容	更新频率	典型落点
稳定层	角色职责、最小授权、通用安全规则	低	自定义 Agent、Rule
任务层	事实提取、方案比较、验证设计流程	中	Skill、任务上下文契约、Checklist
事实层	当前需求、源码、diff、日志和测试结果	高	本次对话或任务输入

稳定层错了
所有任务都会偏

任务层错了
同类任务反复偏

事实层缺失
当前结论必须停止

Agent 之间只交接结构化结果

## 已确认事实
- <证据路径或记录>

## 交接去向
- <应调用的 Skill 或应执行的验证>

## 输入缺口
- <缺少什么，为什么不能继续>

## 不可覆盖的边界
- <权限、范围、状态或发布限制>

交接的是可复核结论，不是把完整对话、推理过程和未经验证的猜测交给下一个 Agent。

Agent 与 Skill 组合的三种失效方式

失效方式	表现	修正方向
Agent 变成万能角色	读、改、测、发、审全都默认允许	按职责拆分，降低工具权限
Skill 被复制进 Agent	多份流程说明彼此不一致	Skill 保持唯一工作流来源
交接只有自然语言总结	下游重新猜事实、范围和验证状态	使用固定输出契约
运行时事实混入资产	换项目仍引用旧路径、字段和权限	把事实移回每次任务输入

组合的目的不是增加层数，而是让角色、工作流和事实各自保持可维护。

7.9 KiB Raw Permalink Blame History