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 沉淀下来。技能目录一旦建好后面每次触发都是零成本复用比每次重新描述一遍提示词省事得多。
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 沉淀下来。技能目录一旦建好后面每次触发都是零成本复用比每次重新描述一遍提示词省事得多。
