TRAE 社区共创「技巧便利店」之 Skills 实战技巧篇

picture.image

TRAE 「技巧便利店」 是 TRAE 官方社区的固定内容栏目,旨在收集用户使用 TRAE 过程中发现的实用小技巧、“神操作”或者“踩坑”经验。

本文根据社区「技巧便利店」活动「好用 Skills」的征集和投票结果,整理了以下 Skills 实战技巧 分享给大家~

文末点击阅读原文 进入官方中文社区,我们期待和更多 TRAE 友共创!

picture.image

基于 Skills 的多智能体分层协作实践

👤用户 @AI发明家

  • AI 的上下文有限,因此在处理复杂任务时,需要将任务分解为多个子任务,每个子任务由不同的智能体负责。

  • 问题:经常会出现这样的情况,某些不该改动的地方被 AI 错误地理解或修改。

  • 为了解决这个问题,我们可以采用分层协作 的方式,将代码分解为多个层级,每个层级由不同的智能体负责。

分享一个基于 Skills 的多智能体分层协作实践:

  • 通过五个层级的 Skills(工具层、数据层、逻辑层、表现层、通信层 )去调度多智能体协作,高效完成任务。

  • 建立六个任务,一个任务总览大局,负责指挥,其他任务负责执行。

  • 然后,设置一个基础规则来规范不同层级的智能体只需要专注于自己负责的层级,而不需要关注其他层级的实现细节。

  • 最后,说明一下层级关系:

  • 数据层通过工具层处理数据来源,获取数据。

  • 表现层和逻辑层通过数据层获取数据来处理业务逻辑,并通过通信层进行数据交换。

picture.image

@Builder 下调用 Skills 技能

👤 用户 @郑柯

分享一个比较实用的“数据对象体检/修复”技能:sc-data-doctor (中间的 data 自己根据需要修改名字 )

  • 做多模块分析/建模流水线的人,应该都遇到过这种尴尬:同一份数据,今天还能跑,明天换个模块就报错;或者不报错,但图和统计指标对不上。

  • 很多时候问题不在算法,而在 “数据对象的契约” 被破坏了**(特别是 AI 生成程序的埋雷 )** ——比如主矩阵、原始视图、分层矩阵、元数据表之间的关系悄悄变了。

  • 这个 Skill 的核心目标很简单:把排查从“经验猜测”变成“基于不变量的体检清单”,并且在必要时做可回滚的修复。

常见的触发场景

  • 结构类报错: 某个模块在读取或计算时提示缺少某个层/视图,或者维度不一致(比如主矩阵有 N 条记录,但某个层只有 N-1;或者特征维度对不上 )。这种问题靠肉眼翻对象很慢,而且越改越乱。
  • 一致性问题(更隐蔽 ): 不报错,但结果“味道不对”。同一指标在不同模块里趋势不一致;可视化使用的是某个变换后的数值,而统计模块用的是另一套数值;或者同一列元数据在不同对象版本里含义被改写。最麻烦的是,这类问题往往要到最后汇总才发现,回头定位成本很高。
  • 版本漂移/协作改动 : 多人协作、对象多次导入导出、合并拆分之后,最容易发生“层丢了 / 类型变了 / 稀疏变稠密 / 字段改名”。流水线能跑不代表契约还在,尤其是跨模块复用时。

Skills 的使用方式

第一段:只读体检(不改任何东西 )

它会先抓几个关键不变量:

  • 主矩阵/各层的 Shape 是否一致(记录数、特征数 )

  • 分层数据是否齐全、命名是否符合预期

  • 数据类型是否合理(例如计数层应非负;变换层允许小数 )

  • 元数据表是否存在关键字段、是否出现重复/空值/类型异常

  • 稀疏/稠密格式是否会触发下游兼容性问题(很多坑就卡在这里 )

第二段:必要时修复(生成修复版,不覆盖原件 )

  • 避免“修复=直接覆盖”,给自己留更多的容错空间。

  • 这个 Skill 的思路是:只在体检确认问题存在时才修复,并且优先走“生成修复版对象”的策略,保证你随时能回退到原始版本。

第三段:回归验证(确认修复真的生效 )

  • 修完不等于安全,我会用同一套体检不变量做一次回归:层是否齐全、维度是否统一、类型是否合理、关键字段是否仍在。

  • 通过这一步,基本能把“修完又引入新不一致”的风险压下去。

这个 Skill “真正在用”的地方在于:它处理的不是某个业务问题,而是所有数据工程都会遇到的对象契约问题。

尤其当你在做跨模块复用、结果交付、或需要把一条流水线跑得更稳的时候,这类体检比“再调一调参数”更救命。

picture.image

小程序性能优化的 Skill

👤 用户 @大毛

  • 分享创建的一个小程序性能优化的 Skill,主要功能是识别小程序性能瓶颈并提供优化建议。

  • 在开发过程中检测性能问题时调用,或用户主动请求性能优化时使用。

  • 下面是使用结果截图:

picture.image

通过实施上述优化措施,预计可以实现:

  • 启动速度提升 :主包体积减少约 40-50%,启动速度提升 20-30%

  • 运行时性能提升 :页面响应速度提升 30-40%,减少卡顿现象

  • 用户体验提升 :减少白屏时间,提升页面加载速度,降低流量消耗

picture.image

手搓一个“全自动公众号文章生成器”技能

👤 用户 @周先生

结合最近开发的 「道路工程文章生成器」 (WeChat Article Gen),来跟大家拆解一下:一个标准的、可复用的、省 Token 的 TRAE 技能长什么样?

先看东西:技能做出来能干嘛?

这是我用这个技能生成的公众号文章系列——🔗《施工图特训班》

核心能力:

  • 风格自适应: 自动识别是写“原理篇”(暗黑科技风 )还是“实战篇”(工程蓝图风 )。

  • 全自动排版: 生成的 HTML 直接带 CSS 样式,甚至自动生成 Python 脚本把网页截成长图。

  • 深度逻辑: 不是瞎编,而是基于本地 PDF 规范文档生成的硬核内容。

技能解剖学:一个标准技能的构造

很多朋友觉得写技能很难,其实解剖开来,一个健壮的技能文件夹(.trae/skills/你的技能名/ )只需要三个核心部分:

Part 1: 大脑 (SKILL.md)

这是技能的“说明书”。你在这里告诉 TRAE:

  • 我是谁: 技能名称、描述、版本。

  • 怎么用: 定义工作流(Workflow )。比如我的技能里规定了:“第一步先扫描模板文件夹,第二步读取 PDF,第三步生成 HTML”。

  • 硬核技巧: 把 Python 工具代码(如截图工具 )直接写在了 Markdown 的附录里 ,TRAE 运行时会像“特工组装武器”一样,把代码提取出来运行,用完即焚。这样文件夹超干净!

Part 2: 皮肤 (templates/)

这是技能的“素材库”。

  • 我放了 template_theory_dark.htmltemplate_practical_blueprint.html

  • 妙处: TRAE 会自动扫描这个文件夹。以后我想加个“二次元风”,只需要扔个新 HTML 进去,甚至不用改 SKILL.md

Part 3: 知识库 (references/)

这是技能的“底座”。

  • 存放 PDF、Markdown 笔记等。

  • 省 Token 秘籍: 不要把所有知识都塞进 Prompt。让 TRAE 在需要的时候去“阅读”特定文件。

picture.image

为什么即使你会写代码,也要封装成技能?

节省 Token,提高精度!

如果不写技能,你每次都要对 AI 说:“请帮我用这个 HTML 模板,注意要用 CSS 变量,还有记得用 MathJax 渲染公式……” 这一大段话每次都在消耗你的上下文配额。

封装成技能后:

你只需要说:“生成一篇关于路基沉降的实战文章。”

TRAE 会自动:

  • 调出 wechat-road-eng-article-gen 技能。
  • 读取 SKILL.md 里的规则(严禁瞎编、必须查规范 )。
  • 自动写一个 Python 脚本来填充 HTML 模板。
  • 自动调用截图工具生成图片。

这就是“降维打击”:用自然语言触发复杂的工程化流程。

更多技巧可点击阅读原文 进入官方中文社区查看,也欢迎和我们一起共创!

picture.image

0
0
0
0
评论
未登录
暂无评论