初颜's World

  • 首页
  • 个人中心
    • 登录
    • 注册
  • 文章
    • 资源分享
    • 软件分享
    • 影视分享
    • 其他分享
    • 未分类
  • 工具
    • Mikutap
  • 隐私政策
  • 关于
初颜's World
二次元爱好者的小据点
  1. 首页
  2. AI 工作流
  3. 正文

把重复劳动写成 Skill:一套可复用的 Agent 工作流

2026年11月16日 5点热度 0人点赞 0条评论

我前三个月的 DSH 会话里有一半时间在重复同一句话:

把这次改动整理成 changelog,按 feat/fix/refactor 分组,每条一行,不要写「优化了体验」这种话。

后来我把它写成了一个 Skill。现在只需要说「出 changelog」,剩下的我自己都不用记得。

Skill 不是提示词模板

它的区别在于承载的信息种类。一份好的 Skill 至少包含四层:

skill/
├── 何时使用        —— 触发条件,也包括「什么时候别用」
├── 前提与输入      —— 需要哪些文件/环境/凭据
├── 步骤            —— 顺序、分支、每一步的验收点
└── 反证与坑        —— 已知会错的地方,以及怎么自检

最后两层是绝大多数「提示词模板」缺失的部分。它们恰恰是最值钱的——那是你踩过坑之后的经验。

我写的 changelog Skill 里有一整节叫「反模式」:

  • 不要按 commit 顺序列,要按影响面分组
  • 不要出现「若干」「一些」这类词,要么给数字要么删掉
  • 合并同一 PR 里的多条碎 commit
  • 涉及破坏性变更的,必须放在最前面并标注 BREAKING

这四条没有一条是「格式要求」,全是「我被人骂过之后改的」。写进 Skill 之后,它就不会再犯。

一个完整示例:日志排障 Skill

我给自己写的 log-triage:

# log-triage

## 何时使用
用户提供日志片段、错误码,或描述「线上报错了」,但还没有明确根因。

## 前提
- 有日志原文;如果只有截图,先要求原文(截图会丢栈帧)
- 知道服务名与大致时间窗

## 步骤
1. 定位第一个异常,而不是最后一个。后续错误通常是它的连锁反应。
2. 提取栈帧里属于自有代码的最近三帧。
3. 对照三个常见类别判断:
   - 配置类:连接串、超时、环境变量缺失
   - 依赖类:版本不兼容、接口契约变化
   - 代码类:空值、类型、并发
4. 给出「一句话根因 + 一行验证命令 + 最小修复」。
5. 如果证据不足,明确列出还缺哪一条信息,不要猜。

## 反证
- 出现 OOM 时,先看是不是内存泄漏,而不是先调大堆
- 「偶发」的错误优先怀疑并发或重试,不要先怪网络
- 日志里没有时间戳时,结论一律降级为「可能」

## 输出格式
根因:……
证据:……
验证:<可以复制执行的一行命令>
修复:<最小改动>

注意第 5 步「不要猜」。这条是必须显式写的——默认情况下模型很愿意给你一个听起来合理的答案,而排障场景里一个错误结论的代价远高于「我还需要两条日志」。

该不该沉淀:三条标准

不是所有重复都值得写成 Skill。我用三条筛:

  1. 发生过三次以上,且每次我都要重新想一遍怎么说。 一次是偶然,两次是巧合,三次是流程。
  2. 有明确的验收标准。 「写得好一点」没法沉淀;「每个函数都有错误分支」可以。
  3. 错了会疼。 无所谓的任务,沉淀的收益低于维护成本。

反过来说,下面这些我不写 Skill:

  • 一次性探索(「帮我看看这个仓库是干嘛的」)
  • 高度依赖具体上下文的判断(架构评审、人事决策)
  • 每次都要现场讨论的创作类工作

过度流程化是真实的风险

我一度把 Skill 写得像 SOP:12 个步骤、每步三个子项。结果是模型严格照做,遇到第 3 步就该跳过的场景也硬走完,产出反而更差。

后来我学到了两个技巧:

给判断,不给清单。 与其写「检查 A、B、C、D」,不如写「如果 A 和 B 冲突,以 A 为准,因为……」。前者是机械执行,后者是传递判断力。

留一个逃生口。 在步骤末尾加一句:「若上述步骤与实际情况明显不符,先说明冲突再决定,不要强行套用。」这一句能救回大量僵硬执行。

版本化与 review

Skill 是文件,所以它天然可以进 git。我给自己定的规矩:

  • 每次因为 Skill 不到位而返工,就提一个小 commit 补进「反证」一节
  • 每季度看一遍,删掉已经内化成常识的条目(否则上下文白烧)
  • 团队共用时,Skill 的 diff 就是最好的 prompt 评审材料

一年下来,我的 skills/ 目录变成了一个奇怪的资产:它不是代码,也不是文档,而是一份可执行的个人经验。新人拿走它,等于拿走我踩过的坑。

下一篇聊一个更硬的话题:Agent 能动你的文件系统和终端,权限应该怎么给。

本作品采用 知识共享署名 4.0 国际许可协议 进行许可
标签: Agent Skill 工作流 提示词工程
最后更新:2026年11月16日

初颜Sir

这个人很懒,什么都没留下

点赞
< 上一篇
下一篇 >

文章评论

razz evil exclaim smile redface biggrin eek confused idea lol mad twisted rolleyes wink cool arrow neutral cry mrgreen drooling persevering
取消回复

初颜Sir

这个人很懒,什么都没留下

标签聚合
Agent 编程 Windows 免费 破解 工具 软件 JAVA IDEA 电脑
最近评论
初颜Sir 发布于 2 年前(12月19日) :razz:
初颜Sir 发布于 5 年前(01月22日) :huaji14:
初颜Sir 发布于 5 年前(07月09日) 目前失效,耐心等待修复
初颜Sir 发布于 5 年前(07月09日) 目前失效,耐心等待修复
初颜Sir 发布于 5 年前(07月09日) 目前失效,耐心等待修复
最新 热点 随机
最新 热点 随机
别让 Agent 空转:任务拆解、并行与验证的三条经验 Agent 的权限边界:文件沙箱、审批与最小授权实践 把重复劳动写成 Skill:一套可复用的 Agent 工作流 DSH 工具系统拆解:shell、文件读写与 MCP 是怎么串起来的 从脚本到 Agent:我为什么把日常自动化搬进 DeepSeek Harness IDEA-好用的插件推荐
从脚本到 Agent:我为什么把日常自动化搬进 DeepSeek HarnessDSH 工具系统拆解:shell、文件读写与 MCP 是怎么串起来的把重复劳动写成 Skill:一套可复用的 Agent 工作流Agent 的权限边界:文件沙箱、审批与最小授权实践别让 Agent 空转:任务拆解、并行与验证的三条经验
IDEA-2021.3.1及以下版本通杀永久破解---2022.01.02测试有效 FinalShell SSH工具,服务器管理,远程桌面 网易云每天刷300首听歌量【已失效】 别让 Agent 空转:任务拆解、并行与验证的三条经验 从脚本到 Agent:我为什么把日常自动化搬进 DeepSeek Harness 抓包工具 HTTP Debugger Professional 9.09中文版

COPYRIGHT © 2023 初颜's World. ALL RIGHTS RESERVED.

Theme Kratos Made By Seaton Jiang

赣ICP备17014222号