背景
公司每次来新人都需要给新人讲解系统的关键点,让学习快速上手,学习技能,新人入职后会提供一个学习计划了,分配对应的人去教导新人,教导新人的员工由于没有对应的资料,效果往往不够好,编写合适的资料需要时间,这时候使用ClaudeCode的skill可以帮助我们很好的生成教学培训文件
实践
业务流程往往有标准的流程图,但是对于代码方面由于功能比较多,很多逻辑都在代码中,另外一些数据库表结构,接口,业务流程实现等也都在历史代码中
ClaudeCode的发展速度很快,一些skill也能高效率帮助人们开发,认识项目。
这里我通过ClaudeCode的skill快速生成教学文档
bash
我:你有哪些skill?
ClaudeCode:以下是我当前可用的 skills(斜杠命令):
┌───────────────────────────┬─────────────────────────────────────────────────────────────┐
│ Skill │ 说明 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /algorithmic-art │ 使用 p5.js 创建算法艺术,支持随机种子和交互参数 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /brand-guidelines │ 应用 Anthropic 官方品牌色彩和排版风格 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /canvas-design │ 创建视觉艺术设计(PNG/PDF海报等) │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /claude-api │ 构建、调试和优化 Claude API / Anthropic SDK 应用 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /doc-coauthoring │ 协作撰写文档、提案、技术规范等 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /docx │ 创建、读取、编辑 Word (.docx) 文档 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /frontend-design │ 创建高质量的前端界面和 Web 组件 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /internal-comms │ 撰写内部沟通文档(状态报告、项目更新等) │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /mcp-builder │ 构建 MCP(Model Context Protocol)服务器 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /pdf │ 处理 PDF 文件(读取、合并、拆分、加水印等) │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /pptx │ 处理 PowerPoint (.pptx) 文件(创建、编辑演示文稿) │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /skill-creator │ 创建、修改和优化 skills │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /slack-gif-creator │ 创建适用于 Slack 的动画 GIF │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /theme-factory │ 为各种产物(幻灯片、文档、网页等)应用主题样式 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /web-artifacts-builder │ 使用 React + Tailwind + shadcn/ui 创建复杂 Web 产物 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /webapp-testing │ 使用 Playwright 测试本地 Web 应用 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /xlsx │ 处理 Excel (.xlsx/.csv) 表格文件 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /deep-research │ 深度研究 --- 多源搜索、交叉验证、生成带引用的报告 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /update-config │ 配置 Claude Code 的 settings.json(权限、钩子、环境变量等) │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /keybindings-help │ 自定义键盘快捷键 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /verify │ 验证代码变更是否按预期工作 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /code-review │ 代码审查 --- 检查正确性、复用、简化、效率问题 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /simplify │ 简化代码 --- 关注复用、简化、效率优化 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /fewer-permission-prompts │ 减少权限提示 --- 自动添加常用工具的允许列表 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /loop │ 按间隔循环执行任务 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /init │ 初始化项目 CLAUDE.md 文件 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /review │ 审查 Pull Request │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /security-review │ 对当前分支的待提交变更进行安全审查 │
├───────────────────────────┼─────────────────────────────────────────────────────────────┤
│ /run │ 启动并运行项目应用,验证变更效果 │
└───────────────────────────┴─────────────────────────────────────────────────────────────┘
你可以直接输入 /skill名称 来调用对应的 skill,比如 /code-review、/xlsx 等。需要使用哪个?
这时可以选择docx或者pptx去生成对应教学文件,切换到docx skill
bash
❯ /docx
Thought for 27s (ctrl+o to expand)
● DOCX skill 已加载!我可以帮你完成以下 Word 文档相关任务:
┌──────────────────┬────────────────────────────────────────────────────────────────────────────┐
│ 任务类型 │ 说明 │
├──────────────────┼────────────────────────────────────────────────────────────────────────────┤
│ 创建新文档 │ 使用 docx-js 生成全新的 .docx 文件,支持标题、表格、列表、图片、页眉页脚等 │
├──────────────────┼────────────────────────────────────────────────────────────────────────────┤
│ 读取/分析文档 │ 提取现有 .docx 文件的文本内容 │
├──────────────────┼────────────────────────────────────────────────────────────────────────────┤
│ ✏️ 编辑现有文档 │ 解包 → 编辑 XML → 重新打包,支持修订追踪和批注 │
├──────────────────┼────────────────────────────────────────────────────────────────────────────┤
│ 转换格式 │ .doc → .docx、.docx → PDF 等 │
└──────────────────┴────────────────────────────────────────────────────────────────────────────┘
│ 读取/分析文档 │ 提取现有 .docx 文件的文本内容 │
├──────────────────┼────────────────────────────────────────────────────────────────────────────┤
│ ✏️ 编辑现有文档 │ 解包 → 编辑 XML → 重新打包,支持修订追踪和批注 │
├──────────────────┼────────────────────────────────────────────────────────────────────────────┤
│ 转换格式 │ .doc → .docx、.docx → PDF 等 │
└──────────────────┴────────────────────────────────────────────────────────────────────────────┘
执行后,项目文件成功生成
✅ 教学文档已成功生成!
文件位置: D:\Project\easychange-recycle-business-evaluation\easychange-recycle-business-evaluation-教学文档.docx
文档包含以下14个章节:
┌───────────────────────┬───────────────────────────────────────────────────────────────────────────────────┐
│ 章节 │ 内容 │
├───────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤
│ 封面 │ 项目名称、版本号、编写信息 │
├───────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤
│ 1. 项目概述 │ 项目简介、核心业务能力、技术栈概览、架构特征 │
├───────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤
│ 2. 项目结构 │ 包结构总览(含19个核心包的职责与核心类) │
├───────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤
│ 3. 核心模块详解 │ Dubbo服务层、估价引擎(2600行)、估价流程、基准价格公式、不吉利数字规避、掉档挽救 │
├───────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤
│ 4. 设计模式与架构特色 │ 策略模式(6渠道)、AES加密、位标志、产品卡片、模糊估价 │
├───────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤
│ 5. 配置体系 │ 配置文件总览、Heracles动态配置、业务配置亮点 │
├───────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤
│ 6. 消息队列 │ RocketMQ Topic与消费者说明 │
├───────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤
│ 7. 定时任务与分布式锁 │ CategoryMaxSubsidyTask、Redis可重入锁 │
├───────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤
│ 8. 工具类详解 │ 11个工具类的职责与关键方法 │
├───────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤
│ 9. Dubbo服务依赖 │ Provider接口与Consumer依赖 │
├───────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤
│ 10. 数据流转全景 │ 估价流程和线下估价的数据流 │
├───────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤
│ 11. 关键配置项速查 │ Dubbo、数据库、Redis、RocketMQ配置 │
├───────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤
│ 12. 开发指南 │ 环境搭建、新增渠道、新增Dubbo服务、配置变更 │
├───────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤
│ 13. 常见问题与排查 │ 估价为0、ID解密失败、分布式锁、Dubbo超时 │
├───────────────────────┼───────────────────────────────────────────────────────────────────────────────────┤
│ 14. 附录 │ 依赖关系图、关键词索引、联系方式 │
└───────────────────────┴───────────────────────────────────────────────────────────────────────────────────┘
文档包含目录、页眉页脚、专业排版样式,可以直接用 Word 打开阅读。

也可以通过/pptx skill生成


总结
通过skill生成的文档,可以快速让新人了解系统知识。在提效的场景中,新人能够快速融入,大大降低了新人的学习成本,也是AI提效的体现之一,而且随着ai的能力提升,文档中的准确率也非常高,开发人员只需要微调就可以,不用进行页面排版等工作,有效提升了工作效率