首页/新闻资讯/正文详情

Claude Design 初体验:用 skill-creator 与 CLAUDE.md 搭建可复用技能骨架

发布时间:2026/9/26 13:20:53 来源:云帆数科 栏目:资讯中心
Claude Design 初体验:用 skill-creator 与 CLAUDE.md 搭建可复用技能骨架
1. 从零散提示词到可复用技能我踩过的坑Claude Design 初体验里最值得先动手的不是写多复杂的提示词而是把「每次都要重新说一遍」的重复劳动沉淀成技能。skill-creator 就是干这个的它是一个元技能你告诉它「我要一个批量生成中药素材的技能」它会帮你生成技能目录、SKILL.md 骨架和触发描述。配合 CLAUDE.md 做项目级约束、PROGRESS.md 做长线进度跟踪三者职责分清楚才不会出现「AI 自己都搞不清任务做没做完」的情况。这篇适合两类人一是刚接触 Claude Design、想把手头提示词工程化的新手二是已经在用 Claude Code 做长线项目、被上下文丢失和进度错乱折磨过的开发者。我会给出可直接复制的技能目录骨架、CLAUDE.md 配置片段、PROGRESS.md 的颗粒度划分以及一次技能触发验证动作。核心检索词就三个skill-creator 生成技能目录、CLAUDE.md 职责边界、PROGRESS.md 进度跟踪。先说结论CLAUDE.md 只放「最新项目架构 进度摘要」PROGRESS.md 放「当前正在做的任务细分进度」TODO.md 放「已完成信息」。三个文件各管一段模型读取时不会因为文件过大而只读到一半就漏信息。下面按顺序拆。2. TaoToken 前置把模型调用通道先打通在折腾技能骨架之前得先有一个稳定的模型调用入口。我用的是 TaoToken 的 API 通道官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它本身不是编辑器也不替代 Claude Code只是把模型请求这条路铺平让你在本地工具里能稳定调到模型。你需要先拿到 API Key。进入控制台创建密钥路径是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 密钥管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建后复制那串 key后面配置环境变量要用。注意API Key 只显示一次创建后立刻存到本地密码管理器或环境变量里别直接写进会提交到 Git 的配置文件。如果你只是想先验证模型能不能正常对话可以直接用模型对话页试一句 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。确认通道通了再往下做技能骨架否则后面报错你分不清是技能配置问题还是通道问题。3. 可复制配置技能目录骨架 CLAUDE.md PROGRESS.md3.1 技能目录骨架skill-creator 生成的技能目录结构我实测下来最稳的是这样.claude/ └── skills/ └── herb-material-gen/ ├── SKILL.md # 技能主文件含触发描述和执行步骤 ├── references/ │ └── herb-list.md # 中药清单等参考数据 └── scripts/ └── batch_gen.py # 批量生成脚本可选SKILL.md 的头部要写清楚触发条件这是技能能不能被正确唤起的关键--- name: herb-material-gen description: 批量生成中药素材组图。当用户提到生成中药素材批量出图中药组图时触发。 --- # 中药素材生成技能 ## 执行步骤 1. 读取 references/herb-list.md 获取中药清单 2. 按每批 4 或 9 个分组 3. 调用图像生成接口每组输出一张组图 4. 结果写入 output/ 目录文件名用中药拼音description 里把触发词写具体别只写「生成素材」否则模型在别的场景也会误触发。3.2 CLAUDE.md 配置片段CLAUDE.md 只保留最新架构和进度摘要篇幅压到最短# 项目约束 ## 架构 - 前端辨证游戏壳子舌诊→脉诊→问诊→辨证→选方 - 后端Hermes AgentAI 对话层已跑通未接入游戏 - 素材中药素材由 herb-material-gen 技能批量生成 ## 进度摘要 - 当前阶段背包系统联调 - 详见 PROGRESS.md已完成项见 TODO.md ## 编码原则 - 先让代码跑起来再让代码优雅起来 - 测试性功能一律走分支或 git worktree禁止直接在主分支开发关键点CLAUDE.md 里不要写详细任务状态。我之前把架构、已完成、进行中全塞进去结果模型 update 时只更新了已完成、漏了进行中反反复复围着一个任务打转。3.3 PROGRESS.md 与 TODO.md 的职责划分# PROGRESS.md — 当前正在做的任务 ## 背包系统联调 - [ ] 原始中药数据接入 - [x] 中药饮片分类 - [ ] 方剂数据结构定义 - [ ] 书籍条目关联 ## 下一步 接入辨证游戏壳子的选方触发逻辑# TODO.md — 已完成信息 - [x] 辨证游戏壳子整合舌诊→脉诊→问诊→辨证→选方 - [x] 煎药游戏壳子选方结束触发配伍煎药 - [x] Hermes Agent backend AI 对话层跑通这样模型读 PROGRESS.md 时文件小、信息集中不会因为默认只读 100 行而漏掉关键状态。4. 验证请求确认技能真的被触发配置完别急着往下写业务先做一次技能触发验证。在 Claude Code 里输入一句自然语言看它是否自动加载了对应技能帮我批量生成 9 个中药素材组图如果 SKILL.md 的 description 写得对模型应该会去读.claude/skills/herb-material-gen/SKILL.md然后按步骤执行。你可以观察它的工具调用记录确认它读了 references/herb-list.md。再验证一次 CLAUDE.md 和 PROGRESS.md 的加载当前背包系统联调进行到哪一步了正确的结果是模型读 PROGRESS.md回答「原始中药数据接入未完成、中药饮片分类已完成」这类具体状态而不是含糊地说「正在开发中」。如果它答得含糊说明 PROGRESS.md 颗粒度太粗或者 CLAUDE.md 里塞了太多干扰信息。提示验证阶段建议用模型对话页单独测一轮确认技能描述和文件加载逻辑没问题再回到本地项目里跑。模型对话入口 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite5. 本篇常见错排查技能不触发九成是 SKILL.md 的 description 太泛。把触发词写具体比如「生成中药素材」而不是「生成素材」。另外确认技能目录放在.claude/skills/下层级别放错。模型读文件只读一半这是 read 工具默认读 100 行导致的。解决办法就是把大文件拆小CLAUDE.md 只留摘要详细进度挪到 PROGRESS.md。文件越小越不容易漏信息。进度状态自相矛盾同一个任务在 CLAUDE.md 和 PROGRESS.md 里都写了状态模型更新时只改了一处。记住单一真相源原则进度只在 PROGRESS.md 里维护CLAUDE.md 只放摘要。测试代码污染主分支上下文有限别指望靠对话历史回滚。测试性功能一律用 git worktree 或独立分支确认无误再合入主分支。Git 提交记录才是唯一真相源。API 调用报错分不清原因先确认 TaoToken 通道本身是通的再排查技能配置。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有完整的请求示例和参数说明。6. 把技能沉淀成长期资产如果你只是偶尔用一次模型那提示词随手写写无所谓。但一旦进入长线项目比如我这种要反复迭代游戏壳子、批量出素材的场景技能化就是必须的。skill-creator 帮你把重复劳动固化成目录CLAUDE.md 约束项目边界PROGRESS.md 跟踪当前进度git worktree 保证每次尝试都可回滚。长期做编码和 Agent 开发的话可以考虑 Coding Plan把模型调用额度固定下来不用每次临时申请 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。Claude Code 相关的接入配置在 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 里面有环境变量和配置文件的具体写法。最后留一个我自己的习惯每次新建技能前先问自己「这个操作我是不是已经做过三遍以上了」。如果是就该用 skill-creator 沉淀下来。技能目录一旦建好后面每次触发都是零成本复用比每次重新描述一遍提示词省事得多。

相关推荐

从 Prompt 到 Loop:用 TaoToken 统一 Key 搭建 Harness 工程骨架的思考
从 Prompt 到 Loop:用 TaoToken 统一 Key 搭建 Harness 工程骨架的思考

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

cPanel到宝塔迁移指南:WordPress网站搬家避坑全流程
cPanel到宝塔迁移指南:WordPress网站搬家避坑全流程

1. 迁移前先摸清两边的环境差异,别等搬完才哭1.1 不是复制粘贴那么简单:cPanel与宝塔的底层逻辑差别很多人第一次做cPanel到宝塔的迁移,下意识以为就是"打包下载,上传解压"这两步。真这么干,大概率会在站点打… · 2026/9/26 13:20:46

Seedance2真人脸适配四大核心瓶颈与工程化破局方案
Seedance2真人脸适配四大核心瓶颈与工程化破局方案

1. 这不是“换脸”,而是可控的人脸驱动——Seedance2真人脸适配的本质问题Seedance2作为当前主流的AI舞蹈生成工具,其核心能力在于将静态人物图像转化为具有自然肢体动作与节奏感的动态视频。但很多人在首次尝试时会发现:上传自己清晰正脸照后… · 2026/9/26 13:20:46

国产电压基准芯片引脚兼容替代方案与实测选型指南
国产电压基准芯片引脚兼容替代方案与实测选型指南

1. 为什么现在必须认真看这份国产电压基准替代清单最近两周,我连续接到五家做工业传感器模块的客户电话,问题高度一致:“TI的REF5025、REF5040、REF62xx系列突然没货,交期拉到24周,报价翻了1.8倍——有没有能直接焊上去… · 2026/9/26 14:41:01

芯片烧录自己做还是外发代工?设备、质量、交期三笔账算清量产决策
芯片烧录自己做还是外发代工?设备、质量、交期三笔账算清量产决策

有些朋友找到我,第一句话就是:“我该不该自己买台烧录器来烧芯片?”这个问题,我在不同公司、不同项目阶段被问过很多次。芯片烧录——把固件写进芯片这道工序,看起来简单得不能再简单:无非是把芯片放到烧录… · 2026/9/26 14:41:01

高可靠性压力温度双模传感方案设计与工程落地
高可靠性压力温度双模传感方案设计与工程落地

1. 这不是普通传感器组合,而是一套专为“地狱模式”工况设计的压力-温度双模感知方案你手头如果正面对海上钻井平台的井口监测、深海ROV机械臂末端反馈、高温蒸汽管道在线诊断,或者化工反应釜内部实时状态追踪这类任务,那MS5849-07BA和R7KA8T… · 2026/9/26 14:41:01

电能计量芯片报警机制:硬件引脚与寄存器双路径原理与协同设计
电能计量芯片报警机制:硬件引脚与寄存器双路径原理与协同设计

1. 为什么工程师第一次接触计量芯片报警功能时,总在硬件引脚和寄存器之间反复纠结?刚接手三相电能表项目那会儿,我被安排调试一款国产计量芯片——型号不提,但它的数据手册厚得像本新华字典。翻到“Alarm Function”章节时&#x… · 2026/9/26 14:40:55

Peter Piper绕口令发音训练:音标拆解、录音对比与语音评测
Peter Piper绕口令发音训练:音标拆解、录音对比与语音评测

这次我们来看一个非常经典的英语口音练习素材:Peter Piper。它不是普通的英文小句子,而是流传了一百多年的高难度绕口令,英文里通常叫 tongue twister。它的核心价值在于把一组极易混淆的辅音和短元音塞进同一句话里反复出现,让练… · 2026/9/26 14:40:48

企业智能体连接数据库:四条路线对比与选型指南
企业智能体连接数据库:四条路线对比与选型指南

企业智能体连接数据库方案对比分析最近给一家制造企业做智能体落地,技术负责人听说智能体要查数据,第一反应是“让大模型直接写SQL连库查不就完了”。这句话很典型,也是不少智能体项目烂尾的起点。企业智能体连接数据库这件事,表面… · 2026/9/26 14:40:48

数据库课后习题答案别硬背:当测试用例集刷,效率翻倍
数据库课后习题答案别硬背:当测试用例集刷,效率翻倍

简介:万常选版《数据库原理与设计》课后习题答案资源,覆盖第2至6章及第9章,适合正在学习关系模型、数据库建模、关系数据理论与模式求精的本科生、自学者作为复习与自测材料。压缩包共7个文件,含3个doc参考答案、2个sql示例脚本、… · 2026/9/26 0:00:21

OpenClaw 替代品?Hermes Agent 踩坑实录:macOS 飞书接入 TaoToken 配置
OpenClaw 替代品?Hermes Agent 踩坑实录:macOS 飞书接入 TaoToken 配置

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

向下兼容与向上兼容:接口设计中的兼容性策略与工程实践
向下兼容与向上兼容:接口设计中的兼容性策略与工程实践

一次版本升级事故,是很多团队绕不过去的坎。线上环境里,服务端明明已经上线了新版接口,老的移动端还在照着旧文档传参数。请求一到网关,校验直接拒绝,用户操作失败,客服群炸了锅,开发群里开始互… · 2026/9/26 0:00:46

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码