什么是skill

claude code 更换MiniMax

一般下载好claude code cli 之后，模型配置文件settings.json，会在这这个文件夹下C:\Users\Administrator\.claude

然后去minimax的管网中申请好api key

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "自己的api key",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ANTHROPIC_MODEL": "MiniMax-M2.1",
    "ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2.1",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.1"
  }
}

模型更换完成

创建skills技能包

windows 在 该  目录 C:\Users\Administrator\.claude  下创建 skills文件夹

在文件夹内容就可以创建自定义的技能，如“会议总结助手”

每个技能中，必须得有一个文件 SKILL.md

该文件中 必须得有 name 和 description 这两个信息

其中，name 必须和 技能名称 一致

---
name: 会议总结助手
description: 该技能用于根据会议录音总结内容
---

# 会议总结助手

## 总结规则

请将会议内容总结为以下几点：

- 参会人员
- 议题
- 决定
- 财务提醒：仅在提到“钱、预算、采购、费用”时触发。须读取 `集团财务手册.md`，指出决定中的金额是否超标，并明确审批人。

注意：每项都只能分别使用一句话来表述，不要分成多条。


## 上传规则

如果用户提到“上传”、“同步”或“发送到服务器”，你必须运行 upload.py 脚本将总结内容上传到服务器。脚本使用方法：

```python
python upload.py "会议总结内容"
```

## 示例

输入：

张三：那我们开始吧，今天主要是把下个月社区志愿活动的安排一次性定下来。
李四：我建议活动放在公园，人多也方便组织。
王五：可以，不过要提前申请场地，不然可能有风险。
赵六：场地申请我可以负责，这周内给大家结果。
孙七：人数最好先有个范围，方便准备物资。
张三：那就先按 50 人左右来估算吧。
李四：上次的手套还能用，但垃圾袋需要再买。
王五：预算要不要设个上限，避免超支。
张三：预算控制在 1000 以内，优先用现有物资。
孙七：时间我建议周六上午，天气也不会太热。
李四：九点集合应该比较合适。
赵六：我周三前把申请结果同步到群里。
张三：好，那报名截止时间定在周四晚上。
王五：周五可以统一分组和采购。
孙七：我来负责写报名文案和活动当天的合影安排。
张三：安全方面提醒大家带水，活动结束简单总结一下就行。
张三：那今天就到这，大家按分工推进。

输出：

- 参会人员：张三、李四、王五、赵六、孙七
- 议题：统一确定下个月社区志愿活动的地点、时间、人数、预算及分工安排。
- 决定：活动定在公园并于周六上午九点举行，按约 50 人规模和 1000 预算执行，由赵六负责场地申请、孙七负责宣传及合影，其余成员配合物资和分组。

基础使用测试

总结以下会议内容：

老张：好，会议现在开始，我们这次会议主要是商量下办公室环境调整的事。
小王：老张，咱们休息区那台咖啡机最近老出毛病，是不是得找人修修？
老张：那个我已经报修了，师傅明天下午过来，大家先克服一下。
大李：还有个事，咱们门口那几盆发财树好像快枯了，谁负责浇水啊？
小王：哎哟，最近太忙给忘了，以后我每周一和周四固定去浇一下吧。
大李：行，那这事儿就交给你了。另外，咱们这学期的团建是不是该准备了？
老张：对，大家有什么想法吗？
小王：我想去玩剧本杀，最近新开了一家店口碑不错。
大李：剧本杀太烧脑了，我建议去郊区搞个露营烧烤，大家能彻底放松下。
老张：露营听起来不错，但这周天气预报说有雨，咱们先待定吧。
老张：小王你先去调研下剧本杀和露营的具体地点，咱们下周一再定最终方案。
大李：没问题，那今天就先这样。

没有使用skills来处理任务，（由于将原本默认的大模型替换成了国产minimax大模型，可能需要通过指令来显示调用skills，而使用默认模型时，可能会先判断是否需要使用skills来处理任务，然后进行询问）

显示提到了skills来执行任务，在执行中，大模型会判断这个任务需要使用哪个skill，然后会暂停，询问是否使用“会议总结助手”这个技能

Reference 用法

# 集团财务手册

本手册详细规定了公司各部门在日常办公、差旅及商务活动中的支出限额与审批流程。

## 第一章：办公设备采购 (IT Assets)
1. **更换周期**：笔记本电脑、显示器等固定资产的最低使用年限为 3 年。
2. **采购限额**：
   - 标准办公电脑：单价不得超过 10,000 元。
   - 高性能工作站：单价 10,000 - 20,000 元，需部门总监 (Director) 审批。
   - 特殊定制设备：单价超过 20,000 元，必须由 IT 总监特批，并提交 CFO 最终签字。
3. **招标要求**：单笔采购总额超过 50,000 元时，必须启动至少三方参与的公开招标流程。

## 第二章：国内差旅标准 (Domestic Travel)
1. **住宿补贴 (按城市等级)**：
   - 一线城市 (北京、上海、广州、深圳)：800 元/晚。
   - 新一线及二线城市：500 元/晚。
   - 其他城市：350 元/晚。
2. **交通工具**：
   - 飞行时长 4 小时以内仅限经济舱。
   - 高铁限二等座 (部门副总及以上级别可选一等座)。


## 第三章：商务招待与餐饮 (Entertainment)
1. **招待标准**：
   - 商务正餐：人均限额 300 元。若超过 300 元/人 (如上海、香港等高消费地区最高可至 500 元/人)，需附完整参会名单并提交业务副总裁 (VP) 特批。
2. **随访要求**：内部陪同人员人数不得超过外部客人数。

## 第四章：日常零星报销
1. **自主额度**：单笔 500 元以下的办公杂费支出可由员工自主报销。
2. **主管审批**：500 元至 5,000 元的支出由部门直接主管在系统内审批。

## 第五章：市场活动与公关
1. **预算申报**：所有涉及品牌推广、市场活动的预算需提前 14 天提交 OA 流程申报。
2. **礼品采购**：单份赠礼价值上限为 300 元。

---
*注：以上所有金额单位均为人民币 (CNY)。违反以上限额且未获得特批的申请，财务部将予以退回。*

在SKILL.md中加上 文件 引用 `集团财务手册.md`

本次会议纪要涉及了  钱，大模型需要额外读取的 文档内容  属于 条件触发，用不到的时候并不会读取占用上下文内容

总结以下会议的内容：

老陈：小李，下周二你跟我去趟上海，咱们得把那个大客户签下来。
小李：没问题陈总，那我今天先把出差申请给报了。
老陈：行，酒店你看着订，要方便出行的，外滩那边有个酒店不错，大概 1200 一晚。
小李：1200 稍微有点贵，但我看那地段确实好，那我就按这个金额报了？
老陈：报吧。另外晚上咱们得请客户吃顿饭，规格得高一点。
小李：明白，我预订个 3000 块左右的包间，咱们一共 6 个人，这标准行吗？
老陈：行，人均 500 在上海这种地方也算正常，为了签单这钱该花。
小李：好，那我申请单里的住宿填 1200，餐饮填 3000，我待会直接提交系统。
老陈：可以，你动作快点，审批完了咱们好赶紧订票。
老陈：没别的事就先去忙吧。

Script用法

直接跑脚本工具

import sys
import time

def upload_summary(content):
    print("\n[System] 启动上传程序 ... ")
    time.sleep(0.5)

    print("[System] 正在连接公司内部服务器 (https://api.internal.wiki) ... ")
    time.sleep(1.2)

    # 模拟数据处理
    print(f"[System] 正在上传总结内容 (字符数: {len(content)}) ... ")
    time.sleep(1.0)

    print("________________________________________________________")
    print("✅ 上传成功！")
    print(f"📄 文档已保存至: /meetings/2024/summary_{int(time.time())}.md")
    print("🔗 预览链接: https://wiki.internal.com/view/99281")
    print("________________________________________________________")

if __name__ == "__main__":
    # 获取 Claude 传入的总结文本
    if len(sys.argv) > 1:
        summary_text = sys.argv[1]
        upload_summary(summary_text)
    else:
        print("❌ 错误：未接收到总结内容。")

在SKILL.md文件中再加入

总结以下会议的内容，并上传到服务器中：

老张：好，会议现在开始，我们这次会议主要是商量下办公室环境调整的事。
小王：老张，咱们休息区那台咖啡机最近老出毛病，是不是得找人修修？
老张：那个我已经报修了，师傅明天下午过来，大家先克服一下。
大李：还有个事，咱们门口那几盆发财树好像快枯了，谁负责浇水啊？
小王：哎哟，最近太忙给忘了，以后我每周一和周四固定去浇一下吧。
大李：行，那这事儿就交给你了。另外，咱们这学期的团建是不是该准备了？
老张：对，大家有什么想法吗？
小王：我想去玩剧本杀，最近新开了一家店口碑不错。
大李：剧本杀太烧脑了，我建议去郊区搞个露营烧烤，大家能彻底放松下。
老张：露营听起来不错，但这周天气预报说有雨，咱们先待定吧。
老张：小王你先去调研下剧本杀和露营的具体地点，咱们下周一再定最终方案。
大李：没问题，那今天就先这样。

而且需要注意的是，Agent是去使用 Bash 执行 脚本文件，并没有读取文件中的内容，至于如何使用该文件，需要传入哪些参数，都是在SKILL.md中规定好的，这种机制的思想和条件触发，按需加载的Reference类似，都会节省token，并且也会加快Agent的整体响应速度

总结

1. 核心定义与设计理念

Agent Skill 的本质是由指令、脚本和资源组成的组织化文件夹。它旨在将通用的智能体（如 Claude）转化为能够胜任特定领域（如 PDF 编辑、复杂代码重构）的“专家”。

• 设计原则：渐进式披露（Progressive Disclosure）。这是 Skill 的核心灵魂，类似于手册的组织方式：先给目录，再给章节，最后给附录。这种机制允许智能体在不耗尽上下文窗口的情况下，挂载理论上“无限量”的背景知识。

2. 三层核心机制

根据文档，Skill 通过三个层级的深度来控制信息的流动：

• 第一层：元数据（Metadata）

    ◦ 内容： 存放于 SKILL.md 开头的 YAML 字段中，包含 name（名称）和 description（描述）。

    ◦ 作用： 在智能体启动时预加载到系统提示词中。这相当于给智能体一张“技能清单”，让它在面对任务时知道有哪些工具可用，而无需加载具体内容。

• 第二层：核心指令（Body of SKILL.md）

    ◦ 触发： 当 Claude 判断当前任务与某个 Skill 相关时，它会调用工具（如 Bash）读取 SKILL.md 的完整全文并加载到上下文中。

    ◦ 内容： 包含执行该任务的具体 SOP（标准作业程序）、逻辑分支和动作定义。

• 第三层：扩展资源（Additional Files）

    ◦ 机制： 当 SKILL.md 过于臃肿，或者某些信息仅在特定场景（如填表）下需要时，可以将这些信息剥离到同目录下的其他文件中（如 reference.md 或 forms.md）。

    ◦ 作用： 智能体仅在需要时通过 SKILL.md 中的引用去“导航”并发现这些文件。这实现了极致的按需加载，最大限度节省 Token。

3. 使用方式与组件功能

Skill 文件夹通常包含以下两类关键组件，以提供不同类型的支持：

A. Scripts（脚本/代码工具）

• 特性：确定性执行。大模型擅长推理，但在处理诸如大规模列表排序、精确数据提取等任务时，Token 生成既昂贵又不可靠。

• 使用方式： 开发者在 Skill 中内置 Python 或 Bash 脚本。智能体可以根据任务自主决定运行这些脚本。

• 优势： 提供传统代码的可靠性和重复性，且无需将原始数据或脚本内容全部塞进上下文，只需获取执行结果即可。

B. References（参考资料/RAG 增强）

• 特性：结构化背景知识。

• 使用方式： 将领域文档、API 手册、成功案例或常见错误（Self-reflection）存放在辅助的 .md 文件中。

• 评论视角： 这种方式被形象地称为**“丐版 RAG”**。它通过文件系统的按需读取，实现了比传统 RAG 更细颗粒度的控制，同时降低了技术门槛，使得非开发者（如律师、分析师）也能通过整理文件夹来构建智能体。

4. 独特的技术特性：上下文共享

与传统多智能体系统（Multi-Agent Systems）通常隔离每个智能体的上下文不同，Claude Code 的 Skill 机制支持上下文共享。

• 当触发 Skill B 时，智能体依然保留着之前操作 Skill A 的历史信息。这种设计让 Agent 能够在一个连续的对话流中协同使用多种专业技能，更符合人类专家的工作习惯。

5. 最佳实践与建议

• 从评估开始： 先观察智能体在哪些任务上挣扎，再针对性地构建 Skill 填补空白。

• 结构化扩展： 当 SKILL.md 变得难以维护时，应及时拆分文件。

• 与 AI 共同迭代： 在任务执行成功后，可以直接要求 Claude 将成功的路径或教训捕获到 Skill 文件夹中，实现技能的自我进化。

• 安全审计： 仅安装来自可信来源的 Skill，因为其中的 Script 可能包含恶意代码或外传数据的指令。