戰小欢
发布于 2026-01-04 / 69 阅读
0
0

基于 CodeBuddy + Skills 的 AI 编程实践

#AI

从“教 AI 回答问题” → “让 AI 执行流程”

一个帮助你将重复性任务、专业知识和常用工具打包成可复用技能的完整解决方案。


为什么需要 Skill?

核心问题:AI 有知识,但没有技能

当前 AI Coding 工具面临的本质问题是:

 AI 知道很多(模型训练语料 + RAG)

 但 AI 不会做事(不懂流程、不懂时机、不懂工具组合)

具体表现为:

 提示词冗长低效: 复杂任务依赖长提示, 效率低且难复用, 无法沉淀能力。

 协作流程混乱: 团队使用 AI 方式不统一, 知识碎片化难以显性沉淀。

 上下文资源浪费: 每次对话重复 "教育"AI,Token 消耗大易超限。

 专业能力欠缺: 通用 AI 缺乏领域深度, 无法组装技能解决复杂问题。

👉 Skill 出现的原因

为了解决「隐性经验无法被 AI 使用」的问题,让 AI 从“回答问题”进化为“完成任务”。

Skill 是什么?

Skill 的定义

Skill 是对“专业经验 + 流程 + 工具 + 规则”的结构化封装

在形式上,Skill 是一个标准化的文件夹能力单元,核心文件是 SKILL.md。

Skill ≠ Prompt Skill ≠ 知识库 Skill = 可执行的能力模块 Skill 解决的不是“说什么”,而是:

 什么时候做

 按什么流程做

 用哪些工具做

 做到什么程度算完成

 

组成

my-skill/

├── SKILL.md (必需)

│ ├── YAML 前置元数据 (必需)

│ │ ├── name: (必需)

│ │ └── description: (必需)

│ └── Markdown 指令 (必需)

└── 捆绑资源 (可选)

├── scripts/ - 可执行代码 (Python/Bash 等)

├── references/ - 参考文档

└── assets/ - 输出文件 (模板、图标、字体等)

 

例子:

Skill 的运行过程

Skill 不是一直加载的,而是采用 渐进式披露机制

阶段

Skill 行为

消耗 token

作用

AI 启动时

仅加载 name、description

每个 skill 大约 100tokens

让系统知道“具备哪些可用的能力”

任务识别时

加载 SKILL.md 核心流程

通常不超过 5000tokens

描述主要流程、操作要点和约束条件

执行阶段

按需加载脚本、资源

无限制

执行任务

👉 这解决了两个关键问题:

 上下文臃肿

 Token 成本过高

 

运行过程解析

通过抓包分析 Claude Code 的 System Prompt,可以清晰地看到 Skill 机制是如何被注入到 AI 上下文中的。

它包含三个关键部分:使用说明技能列表触发机制

1. Tool 定义解析 (抓包信息拆解)

以下是实际抓取到的 System Prompt 片段(为了便于理解,只拆解了关键标签):

 <skills_instructions> (指令集)

 这是 Skill 的“总控制器”。它告诉 AI:何时用:当遇到特定任务时,检查下面的列表。

 怎么用:只需要输出技能名称(如 skill: "skill-creator"),不要加参数。

 发生什么:系统会显示 loading 状态,并将该 Skill 的详细 Prompt 动态注入到当前会话中。

 <available_skills> (技能注册表)

这里列出了当前项目所有可用的 Skill 索引。注意,此时 AI 只知道技能的名字和简介,并不知道具体怎么做(这样极大地节省了 Token)。

它包含三个关键部分:使用说明技能列表触发机制

<!-- 抓包到的 Tool 定义片段 -->
<tool_definition>
    <skills_instructions>
        Invoke skills using this tool with the skill name only.
        When you invoke a skill, the skill's prompt will expand and provide detailed instructions.
    </skills_instructions>
    
    <available_skills>
        <!-- 这里的每个 entry 对应 .claude/skills/ 下的一个目录 -->
        <skill>
            <name>skill-creator</name>
            <description>Guide for creating effective skills...</description>
            <!-- 注意:这里没有 <instructions>。
                 在未调用前,AI 只有 name 和 description。
                 真正的指令内容在 SKILL.md 中,只有被调用时才会被加载。 -->
        </skill>
        <skill>
            <name>pdf-skill</name>
            <description>Guide for pdf operation...</description>
        </skill>
        <!-- ...更多 skill -->
    </available_skills>
</tool_definition>

claude skill 包

github 地址:https://github.com/anthropics/skills

skill 包介绍:

一、核心元技能(Meta Skills)

这类技能用于辅助创建和管理其他 Skill,是构建自定义技能的基础工具:

1. skill-creator功能:提供创建有效 Skill 的完整指南,包括 Skill 的结构设计、资源组织、编写规范(如 YAML 前置元数据、Markdown 指令编写)、渐进式披露设计原则等。适用于用户需要新建 / 更新 Skill 时,指导其封装专项知识、工作流或工具集成能力。

2. template-skill功能:最基础的 Skill 模板,包含必填的 SKILL.md 结构(YAML 前置元数据 + 空指令区域),作为新建 Skill 的起点,用户只需替换名称、描述和具体指令即可快速初始化。

二、创意与设计类(Creative & Design)

专注于生成创意内容、视觉设计相关的能力:

1. algorithmic-art功能:使用 p5.js 创作生成式艺术,支持种子随机数、流场、粒子系统等算法,可生成独特的视觉艺术作品。

2. canvas-design功能:遵循设计原则创建高质量的 PNG/PDF 格式视觉艺术,支持自定义视觉风格与布局。

3. slack-gif-creator功能:创建适配 Slack 尺寸限制的动画 GIF,优化 GIF 大小和显示效果,满足即时通讯场景的创意表达。

三、开发与技术类(Development & Technical)

面向技术开发、测试、集成的专项能力:

1. artifacts-builder功能:使用 React、Tailwind CSS、shadcn/ui 组件构建复杂的 claude.ai HTML 制品,支持定制化前端界面开发。

2. mcp-server功能:指导创建高质量的 MCP(Model Context Protocol)服务器,实现外部 API 和服务与 Claude 的集成,扩展 Claude 的外部工具调用能力。

3. webapp-testing功能:使用 Playwright 测试本地 Web 应用,包括 UI 验证、调试、自动化测试用例执行等,保障 Web 应用功能正确性。

四、企业与沟通类(Enterprise & Communication)

适配企业级文档创作、品牌规范、内部沟通的需求:

1. brand-guidelines功能:将 Anthropic 官方品牌色、排版规范应用到各类输出制品中,确保企业品牌视觉一致性。

2. internal-comms功能:编写企业内部沟通文档,如状态报告、新闻通讯、FAQ 等,遵循企业沟通规范与风格。

3. theme-factory功能:为输出制品应用 10 种预设的专业主题,或按需生成自定义主题,统一文档 / 界面的视觉风格。

五、文档处理类(Document Skills)

Anthropic 官方提供的核心文档处理能力(非开源但可参考),支持主流办公文档的创建、编辑、分析:

1. docx功能:创建、编辑、分析 Word 文档,支持修订记录、批注、格式保留、文本提取等高级功能。

2. pdf功能:一站式 PDF 操作工具包,包括文本 / 表格提取、新建 PDF、文档合并 / 拆分、表单处理等。

3. pptx功能:创建、编辑、分析 PowerPoint 演示文稿,支持布局模板、图表、自动化幻灯片生成。

4. xlsx功能:创建、编辑、分析 Excel 电子表格,支持公式、格式设置、数据分析与可视化。

六、合作伙伴技能(Partner Skills)

第三方适配的技能示例,目前包含:

 Notion功能:适配 Notion 平台的专属技能,帮助 Claude 更好地处理 Notion 相关的内容创建、编辑、集成任务(需参考外部链接:Notion)。

补充说明:

1. 所有 Skill 均遵循“自包含”设计:每个 Skill 对应独立目录,核心是 SKILL.md(含元数据和指令),可选包含 scripts/(可执行代码)、references/(参考文档)、assets/(输出用资源)。

2. 这些 Skill 主要用于演示和学习,Claude 付费版已内置部分示例技能,也可通过 API/Claude Code 自定义上传使用。

3. 文档类技能(document-skills)是 Anthropic 生产环境中实际使用的能力快照,展示了复杂二进制文件格式处理的最佳实践。

 

快速入门

1.装CodeBuddy

目前 CodeBuddy IDE & CodeBuddy Code 均支持 Skills(内网版插件近期迭代上线),在使用之前,需安装 CodeBuddy IDE 或 CodeBuddy Code,两者任选其一。非专业开发者,建议使用 CodeBuddy IDE,专业开发者、DevOps、运维工程师以及 Claude Code 用户建议使用 CodeBuddy Code 。

安装 CodeBuddy IDE,下载安装包

- 官网地址:https://copilot.tencent.com/ide

安装 CodeBuddy Code,打开终端 & 执行,一行命令搞定

- 安装方式:npm install -g @tencent-ai/codebuddy-code & codebuddy update

2. 技能包安装与初次体验

由于我们是需要写的是 PPT ,因此需要安装具有 ppt 演示文稿创建、编辑和分析的 Skills 技能包,目前在 Github 上已经有了 Anthropics 官方出品的 Skills 技能包,仓库地址:GitHub - anthropics/skills: Public repository for Skills,我们只需要在 CodeBuddy 中进行应用配置即可使用,其中 document-skills 技能包包含 docx、ppt、pdf、xlsx 4 种 Skill 配置,满足 Word、PPT、PDF、Excell 文件类型的创建、编辑和分析,接下来我们进行安装体验。

2.1 在 CodeBuddy IDE 中装 document-skills 技能包

第 1 步:下载安装包到本地并进行双击解压:document-skills.zip

第 2 步:打开 CodeBuddy IDE,创建好本地文件夹

第 3 步: 进入配置页,找到 Skill 配置路径

其中用户 Skill 是为全局配置,一次配置,任意文件夹都可用,建议选择;项目级 Skill 配置,仅支持在当前项目文件夹可用。

第 4 步:进行导入,我进行导入用户级 Skill

第 5 步:检查是否配置成功,成功后有如下列表

第 6 步(可选):考虑 PPT 场景,建议导入 xlsx、pdf、docxSkills 进行安装,操作方式如上,这些 Skills 完全覆盖了办公场景的 Excell、Word、PPT、PDF 等类型的数据处理。

详细教程见:https://mp.weixin.qq.com/s/2J5XHvI9shzDaGRFUVe5LQ?scene=1&version=5.0.3.99789&platform=mac

概念对比

Feature 功能

Skills 技能

Prompts 提示词

MCP

Projects 项目

Subagents 子智能体

What it provides

它提供的功能

Procedural knowledge 程序性知识

Moment-to-moment instructions

即时指令

Tool connectivity 工具连接性

Background knowledge

背景知识

Task delegation 任务委派

Persistence

持久性

Across conversations 跨对话

Single conversation 单一对话

Continuous connection

持续连接

Within project

项目内

Across sessions 跨会话

Contains

包含

Instructions + code + assets 指令 + 代码 + 资源

Natural language

自然语言

Tool definitions

工具定义

Documents + context

文档 + 上下文

Full agent logic 完整的智能体逻辑

When it loads

加载时

Dynamically, as needed 动态地,按需

Each turn

每一轮

Always available

始终可用

Always in project

始终在项目中

When invoked 当被调用时

Can include code

可以包含代码

Yes 是

No 否

Yes 是

No 不

Yes 是

Best for

最适合

Specialized expertise 专业知识

Quick requests 快速请求

Data access

数据访问

Centralized context 集中式上下文

Specialized tasks 专业任务

参考

https://claude.com/blog/skills-explained

https://mp.weixin.qq.com/s/2J5XHvI9shzDaGRFUVe5LQ?scene=1&version=5.0.3.99789&platform=mac


评论