一句话调起复用提示词:claude-code-from-scratch技能系统(Skills)实战教程

发布时间:2026/11/20 7:25:50

一句话调起复用提示词:claude-code-from-scratch技能系统(Skills)实战教程 一句话调起复用提示词claude-code-from-scratch技能系统Skills实战教程【免费下载链接】claude-code-from-scratchBuild your own Claude Code from scratch. Claude Code 开源了 50 万行代码读不动用 ~5000 行 TypeScript / Python 从零复现核心架构11 章分步教程带你理解 coding agent 精髓项目地址: https://gitcode.com/gh_mirrors/cl/claude-code-from-scratchclaude-code-from-scratch用约 5000 行 TypeScript / Python 从零复现了 Claude Code 的核心架构其中的**技能系统Skills**是本期主角把一段反复使用的提示词比如读 diff 并写 commit message打包成一个 Markdown 文件之后只需输入/commit一句话就能把整套提示词调起来执行。本文将带你理解 Skills 的设计思路并手把手创建自己的第一个技能。为什么需要 Skills 技能系统日常使用 AI 编程助手时你经常会重复输入类似的话读一下 git diff帮我写一个规范的 commit message审查这个文件检查安全漏洞用 conventional commits 格式提交代码每次手打一遍既繁琐又容易前后不一致。Skills 技能系统的解法是把这些提示词存成文件像 shell 脚本一样即装即用。 官方教程称之为AI Shell 脚本——把 AI 工作流模板化一次定义反复复用。详见 docs/09-skills.md。快速上手三步创建第一个技能无需写任何代码一个技能就是一个文件。三步走第 1 步创建技能目录在项目中创建.claude/skills/commit/目录用户级可放在~/.claude/skills/。第 2 步写入 SKILL.md目录里放一个SKILL.md文件前半部分是元信息后半部分就是提示词本身。项目里自带了两个示例技能可直接参考示例一test/skills/commit/SKILL.md示例二test/skills/greet/SKILL.md第 3 步一句话调起启动 CLI 后输入/commit技能立刻生效$ mini-claude /commit feat: add the new thing运行演示不需要 API keynode steps/run.mjs 9这条命令对应仓库里的可执行场景 steps/scenarios/invoke-skill.json。SKILL.md 文件格式详解SKILL.md 由两部分组成frontmatter 元信息提示词正文。--- name: commit description: Create a git commit with a descriptive message when_to_use: When the user asks to commit changes or says commit allowed-tools: run_shell, read_file user-invocable: true --- Look at the current git diff and staged changes. Write a clear, concise commit message following conventional commits format. The users request: $ARGUMENTS各字段的作用一目了然字段作用name技能名即/name调起时的关键字description技能描述展示在系统提示词中when_to_use给模型看的触发条件模型据此判断是否自动调用allowed-tools安全边界限制该技能可用的工具白名单user-invocable设为false时用户不能手动输入只能由模型自动触发contextinline默认或fork决定执行模式解析逻辑集中在 src/skills.tsPython 版对应 python/mini_claude/skills.pyparseSkillFile负责把文件拆成元信息与模板容错处理了逗号分隔和 JSON 数组两种allowed-tools写法。两种调用方式手动 /name 与模型自动触发Skills 支持双路径调用两条路最终汇合到同一个解析函数resolveSkillPrompt()路径一用户手动调用输入以/开头的内容CLI 就会去技能目录里找同名文件。逻辑见 src/cli.ts/commit fix types → 加载 commit 技能参数 fix types 替换进模板路径二模型自动调用你只需自然地说帮我提交代码。此时系统提示词中已经列出了所有可用技能及when_to_use触发条件由 src/prompt.ts 中的buildSkillDescriptions()注入模型判断匹配后会调用内置的skill工具工具返回的是展开后的提示词文本——本质是一个元工具返回值不是数据而是指令。 双路径设计的原因手动调用保证你精确控制触发时机自动调用则让模型在你忘记技能存在时也能主动用上。模板变量让技能接收参数提示词正文中支持两个内置变量$ARGUMENTS替换为你调起技能时传入的参数。比如/commit 修复登录 bug修复登录 bug 就会被注入到模板中${CLAUDE_SKILL_DIR}替换为技能所在目录路径。这样技能可以在目录里附带模板、配置等文件提示词中引用即可替换逻辑只有几行见 src/skills.ts 的resolveSkillPrompt函数L116-L123。inline 与 fork两种执行模式模式行为适用场景inline默认提示词直接拼进当前对话简单、单轮的轻量任务fork提示词交给一个干净的子 Agent 独立执行只把结果带回主对话需要多轮工具调用的重任务如代码审查要读很多文件选 fork 的核心好处保持主对话上下文干净。子 Agent 的工具还受allowed-tools白名单约束且默认排除agent工具防止递归。实现位于 src/agent.ts 的executeSkillTool方法。技能加载优先级项目级覆盖用户级技能从两个来源加载同名时项目级优先~/.claude/skills/—— 用户级低优先级个人所有项目通用.claude/skills/—— 项目级高优先级当前项目专用会覆盖同名用户技能加载顺序写死在 python/mini_claude/skills.py 的discover_skillsL33-L49中先加载 user再加载 project用 Map 去重自然实现后者覆盖前者。解析结果还会缓存避免重复读盘。想更深入核心源码与文档清单资源路径技能系统章节教程docs/09-skills.mdTypeScript 技能实现src/skills.tsPython 技能实现python/mini_claude/skills.pyCLI 中 /name 调起逻辑src/cli.ts技能列表注入系统提示词src/prompt.ts技能示例commit / greettest/skills/fork 模式子 Agent 执行src/agent.ts常见问题 FAQQ1技能必须用代码写吗不需要。技能本体就是自然语言 Markdown会写提示词就会写技能。Q2为什么用 Markdown 而不用 JSON/YAML 存提示词因为技能的本体是大段自然语言。Markdown 正文直接就是提示词JSON 存储反而要转义换行符和引号可读性差。Q3如何验证技能被正确加载在 CLI 中输入/skills会列出所有已发现的技能及其描述输入No skills found则说明目录或文件命名有问题必须是技能名/SKILL.md的目录结构。Q4本地怎么跑起来试试git clone https://gitcode.com/gh_mirrors/cl/claude-code-from-scratch cd claude-code-from-scratch npm install npm run build node steps/run.mjs 9小结Skills 技能系统用一个 Markdown 文件解决了提示词复用问题✅ 一句话/name手动调起或让模型按when_to_use自动触发✅$ARGUMENTS参数化同一技能适配不同输入✅allowed-toolsuser-invocable提供安全与权限边界✅ inline / fork 双模式兼顾轻量任务与重型任务的上下文隔离对照真实 Claude Codemini-claude 还简化了技能来源2 个而非 6 个和 token 预算控制但核心架构完全一致——理解了这几百行源码你就掌握了 Skills 的精髓。下一章可以继续 docs/10-plan-mode.md看看先想清楚再动手的 Plan Mode。【免费下载链接】claude-code-from-scratchBuild your own Claude Code from scratch. Claude Code 开源了 50 万行代码读不动用 ~5000 行 TypeScript / Python 从零复现核心架构11 章分步教程带你理解 coding agent 精髓项目地址: https://gitcode.com/gh_mirrors/cl/claude-code-from-scratch创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/19 11:48:50

TensorRT Plugin开发实战:从Unsupported Layer到自定义算子

第一次被 TensorRT 逼着去读 Plugin(自定义插件)源码,是在部署一个带自定义注意力模块的检测模型时。模型在 PyTorch 里跑得好好的,精度也满足要求,但转成 ONNX 再进 TensorRT,build engine 的时候直接给我…

2026/11/19 16:08:09

QNX开发之ECAT专用网卡驱动ecpkt · 05-接收

QNX开发之ECAT专用网卡驱动ecpkt 05-接收上一章结束时驱动的发送路径已经闭环:50 条测试报文全部被 PC 端收到,write() 一路畅通。但驱动还一帧报文都收不到——接收路径还是空的。这一篇我们来实现接收路径,把报文从网线一路送到应用程序的…

2026/11/20 7:22:29

电工证快速办理怀化有效期多久

怀化电工证快速办理在哪考?怕考不过白交培训费别再踩坑 怕考不过白交培训费?怀化电工证快速办理在哪考,你可能正被这个问题折磨得焦头烂额。其实,大多数人报考特种作业操作证,最怕的不是考试本身,而是花了钱却考不过,耽误时间还影响工作。尤其是现在,…

2026/11/20 7:22:29

菏泽哪里能办电工证怎么报名?过期证书别慌,这样做还能续期

菏泽哪里能办电工证怎么报名?过期证书别慌,这样做还能续期 证书过期了不知道怎么复审延期?这事儿很多人遇到过,特别是像你这样已经在一线干了几年的电工,眼看证书快到期了,却不知道怎么操作,心里慌得不行。其实别担心,菏泽哪里能办电工证,怎么报名,…

2026/11/20 7:22:29

热工特种兵积木视频怎么用?郑州报考避坑指南全解析

热工特种兵积木视频怎么用?郑州报考避坑指南全解析 工地太忙根本没时间复习考试,你是不是也经常这样想?尤其是现在特种作业证考试越来越严格,热工特种兵积木视频成了很多工友备考的新选择。但你知道怎么用这些视频,又怎么在郑州顺利报考吗?这篇文章就从…

2026/11/20 7:22:29

装修电工证需要多少钱学历不高也能考 保姆级流程全公开

装修电工证需要多少钱学历不高也能考 保姆级流程全公开 你是不是也担心自己学历不高,报不了装修电工证?其实不然,只要符合报名条件,学历并不是障碍。装修电工证不仅关系到你的职业发展,还决定了你能不能合法上岗作业。那么, 装修电工证需要多少钱…

2026/11/20 7:17:29

上海 电工证 培训考试真题与备考技巧

上海电工证培训多久拿证?实操考试心里没底怕挂科怎么办? 你是不是也这样,看到【上海电工证培训】几个字就紧张,担心实操考试过不了,更怕耽误拿证时间?尤其像我们信阳浉河区的应届工程类毕业生,对【多久拿证】这个问题格外敏感,毕竟它关系到就业、上岗…

2026/11/19 22:14:34

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/20 6:48:54

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/20 0:00:30

电力电缆制作特种证过期了怎么复审?郑州报考避坑指南全解析

电力电缆制作特种证过期了怎么复审?郑州报考避坑指南全解析 证书过期了不知道怎么复审延期?作为一名在郑州从事电力电缆制作特种作业多年的项目管理员,我亲身经历过证书过期后被责令停工的尴尬场面。那天,我在平顶山某工地进行电缆敷设作业时,被当地应急…

2026/11/20 0:00:30

葫芦岛考低压电工证过期怎么复审?考前押题帮你稳过

葫芦岛考低压电工证过期怎么复审?考前押题帮你稳过 证书过期了不知道怎么复审延期,耽误工作还影响收入?别急,今天就给你讲讲葫芦岛考低压电工证的有效期、复审流程,还有考前押题怎么用,保证你少走弯路。 低压电工证有效期与复审规则…

2026/11/20 0:00:30

济阳从哪里学电工证良心建议:怕考不过白交培训费?看完这篇全明白

济阳从哪里学电工证良心建议:怕考不过白交培训费?看完这篇全明白 你是不是也担心,花了钱去学电工证,结果考试还是不过,白白浪费时间和金钱?特别是济阳这边,培训机构多得是,但真正靠谱的又有几个?今天我就来给你掏心窝子,讲讲济阳从哪里学电工证的良…

2026/11/20 6:49:17

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/19 17:18:32

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑