15.4 子代理与 Skills

面向经管学生、研究者与从业者的 AI 智能体设计教材

作者

李学恒、林建浩、严翊歆

发布于

2026-05-11

文件路由与 Skills 映射

本项目配置了 1 个子代理和 8 个 Skills。子代理负责 Git 提交,Skills 覆盖各类文档处理能力。

子代理:git-commit

▶ Agent
---
name: git-commit
description: Git 提交 agent,用于按逻辑分组提交代码变更。任何需要 git commit 的场景都应调用此 agent。
model: opus
---

你是 Git 提交专家。你的任务是将代码变更按逻辑分组提交。

**工作流:**
1. 检查更改:`git status && git diff`
2. 按逻辑分组提交:用 `git add <具体文件>` 明确暂存,不用 `git add .` 或 `git add -A`
3. 遵循仓库约定:检查 `git log` 查看提交消息格式(通常是 `feat:`、`fix:`、`chore:` 等)
4. 验证:`git status`

**关键原则:**
- 按逻辑分组,不是一股脑全提交
- 遵循项目现有的 commit message 风格
- 绝对不添加 Co-Authored-By
- 提交前确认,push 前询问用户
- 不要自动 push,commit 完成后询问用户是否需要 push

为什么需要专门的提交子代理?自动化办公系统一次可能处理多个任务,产生大量文件变更。如果主代理直接 git add . 全部提交,提交历史会混成一团。git-commit 子代理按逻辑分组:配置文件一组,任务产出物一组,索引更新一组,每次提交都有清晰的变更边界。

Skills 概览

8 个 Skills 分为三类:文档处理(5 个)、格式转换(1 个)、内容生成(2 个)。

Skill 职责 触发条件
minimax-xlsx Excel 创建、读取、分析、编辑 .xlsx / .csv 文件或数据分析需求
minimax-docx Word 文档创建、编辑、排版 .docx 或正式文档输出需求
minimax-pdf 高品质设计 PDF 生成 需要视觉质量的 PDF 输出
pptx-generator PPT 生成、编辑、读取 .pptx 或演示文稿需求
pdf PDF 基础操作 合并、拆分、提取、表单填写
mineru PDF 转 Markdown 需要解析 PDF 内容为文本
work-report 日报、周报撰写 工作总结和汇报
doc-coauthoring 文档协作撰写 长文档结构化写作
文件路由是关键设计

Skills 的数量不是重点,路由逻辑才是。CLAUDE.md 中的文件路由表把文件类型和 Skill 的映射关系写明,AI 按表路由,歧义时询问用户。三个 PDF 相关的 Skill 最容易混淆:pdf 处理现有 PDF(合并、拆分),mineru 把 PDF 转成 Markdown,minimax-pdf 生成新的设计 PDF。

这些 Skills 大多来自开源社区(community skills)。我们获取后将 SKILL.md 翻译为中文,并做了适配中文办公场景的调整。读者也可以从社区获取更多 Skills,或根据自己的需求编写新的 Skill。

本章不展开每个 Skill 的完整定义。读者可从开源仓库获取所有 SKILL.md 文件,按自己的办公需求增减 Skills。