前言¶
一个流程做过两次以上,就值得被写下来。但”写下来”有两种结果:一种是存成一篇 README,下次找出来要靠翻目录,靠人读;另一种是存成一份 Agent 能自己执行的步骤说明,下次直接让 AI 照着跑。
多数团队目前的做法是前者。结果是文档越积越多,Agent 的能力却没有积累下来——每换一个会话,同一个流程要重新交代一遍,交代的内容还常常不全。
下面介绍的 工作转技能(gongzuo-zhuan-jineng)走的是后一条路:把已经跑通的工作,转成一个结构化的 SKILL.md 文件,让 AI 能独立执行。
这是什么¶
一句话定位:把已完成的工作转换成可复现的 Agent Skill(SKILL.md 文件)的元技能。
- 坐标:
@user_9e99a1ca/gongzuo-zhuan-jineng - 发布者:
user_9e99a1ca - 来源:community(社区发布)
- 分类:
ai-agent - 当前版本:3.2.1
- 是否需要 API Key:否(标签
requires_api_key=false) - 官方地址:https://api.skillhub.cn/user_9e99a1ca/gongzuo-zhuan-jineng
- SkillHub 页面:https://www.skillhub.cn/skills/user_9e99a1ca/gongzuo-zhuan-jineng
它解决的问题不是”写文档”,而是”把经验固化成可执行物”。区别在于文档的读者是人,SKILL.md 的读者是模型;后者需要明确的步骤、命令和判定条件,写模糊了就执行不下去。
核心功能¶
依据官方简介,这个 Skill 的能力范围是:
- 把已经完成的工作转换成可复现的 Agent Skill。产物是 SKILL.md 文件,格式上属于通用 SKILL.md,不绑定特定工具链。
- 产出的技能可以由 AI 独立执行,不需要人类在旁逐步指挥。
- 覆盖工作流打包(packaging workflows into skills)。把一段重复性流程拆成可执行步骤。
- 覆盖 AI 教学经验提取(extracting AI teaching experience)。把”教 AI 怎么做这件事”过程中修正过的要点,沉淀进技能里。
- 覆盖创建可复用的 SKILL.md 文件。
- 覆盖技能完整性校验(validating skill completeness)。检查产出的技能是否步骤齐全、有没有缺环节。
需要区分的是,它处理的是”已经做完的工作”。输入源是既有成果,而不是待办清单。
安装与启用¶
官方资料中没有给出安装命令、目录约定或配置文件字段,这部分不要凭空补。以下是资料中可以确认的项:
- 安装来源:community,即社区发布,非官方团队维护。
- 分类:
ai-agent。 - 标签:
requires_api_key=false,说明启用时不需要额外配置 API Key。 - 版本:3.2.1。
要拿到实际的安装命令和启用方式,需要打开官方地址或 SkillHub 页面查看,本机 SkillHub CLI 的实际命令以页面为准。
需要留意的一点:社区来源意味着质量由发布者负责。装之前建议先看页面上的版本记录和说明,再决定是否引入生产流程。
典型用法¶
官方简介里给出了明确的使用场景,可以按这四类来判断是否需要它:
1、要把一个工作流打包成技能时。前提是这个工作流已经跑通,有实际产出,不是设想中的流程。
2、要从”教 AI 做这件事”的过程中提取经验时。适用于已经和 AI 反复协作过、修正过多轮的任务。
3、要创建可复用的 SKILL.md 文件时。适用于团队内有多人、多个会话要重复执行同类任务的场景。
4、要校验技能完整性时。适用于已经有一份 SKILL.md,想确认步骤有没有缺失、能不能独立跑通的场景。
反过来,官方简介明确列出了不适用的情况:通用文档、README、一次性任务、以及还没有实际开展过的工作。
这里要强调”还没有实际开展过的工作”这一条。它不是一个通用的写作辅助工具,输入必须是真实完成过的工作。拿它去写规划、写方案,属于误用。
适用场景与注意¶
适合的人:已经在和 AI 协作跑流程,并且流程跑通了、有稳定产出、希望下次不用重新交代的团队或个人。典型形态是重复性任务,比如定期取数并生成报表、按固定格式处理一批文件。
不适合的人:只写文档归档、没有实际执行过程、或者任务本身只做一次的人。
需要注意的几点:
1、输入质量决定输出质量。工作本身没跑通,转出来的技能也执行不了。
2、SKILL.md 要能被模型独立执行,写的时候必须把命令、路径、参数写全,不能停留在”大概怎么做”的层面。
3、它不做通用文档写作。如果需求是写 README 或方案,不要用这个 Skill。
4、社区来源,用之前先确认版本和维护状态。
5、完整校验能力依赖已有技能的步骤完整性,若原工作本身缺少环节,校验也会一并漏掉。
结尾¶
这个 Skill 的价值在于把”做过的工作”变成”可复用的资产”,而不是变成又一篇文档。对于已经跑通的重复性流程,它能把交代成本压下去,让 AI 下次直接照着执行。
判断标准很简单:这件事做过至少两次,且步骤已经稳定,就值得用它转成技能。
官方地址:https://api.skillhub.cn/user_9e99a1ca/gongzuo-zhuan-jineng