1. 返工的真实成本从一次提审自查失败说起上周用 Claude Code 改一个记账小程序的删除逻辑时我又一次被 Agent 返工烧掉大量 Token。第一轮 Agent 说“已完成”第二轮我发现空状态白屏第三轮又漏了二次确认。每轮我都要重新贴一遍验收标准能删除、能撤销、空列表有文案、不误删其他条目。问题不在模型能力而在流程没有固化——每次都在对话框里临时口述“什么算修好”。后来我把这段流程写成一份 SKILL.md并在 TaoTokenhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentskillmd_intro获取 Key把 Base URL 设为 https://taotoken.net/api返工才降下来。如果你也遇到类似情况后面的配置示例直接复制即可。这篇不重复讲“模型是脑、Agent 是手”的比喻而是把可复用流程装进 SKILL.md 的具体做法拆开四格模板怎么写、Claude Code / Codex / CC Switch 怎么配、Agent 怎么触发、返工怎么降。个人开发者用 Agent 修 Bug、做提审自查最贵的不是模型单价而是反复解释同一件事。一次提审自查如果来回三轮每轮都重新描述范围、验收标准、禁止事项消耗的 Token 可能比修复本身还多。更隐蔽的成本是注意力你本来在验收结果变成了人形说明书。把流程固化成 SKILL.md 之后Agent 在触发词出现时自动加载说明书先对齐验收标准再动手修改最后按固定格式输出。你不再需要每次从零口述返工次数也会明显下降。下面从概念分工开始逐步给出可复制的模板和配置。2. Skill 与提示词、工具的分工别把说明书当能力普通提示词是你这次粘进对话框的一段话。用完就散下次未必说得一样清楚。Skill 是提示词外面多了一层结构通常包含触发时机、适用边界、步骤、禁止事项和输出格式。它不是新模型也不是插件。插件、MCP、工具解决“能不能碰到文件、数据库、接口”Skill 解决“碰到之后按什么规矩干活”。工具管能力边界Skill 管执行标准。个人开发小程序时拆需求、搭页面、修 Bug、提审前自查会反复来。每次从零口述返工和 Token 都贵。Skill 的价值是把已经验证过的说法固化下来少糊问也少把“怎样算过”说漏。比如“删除逻辑修好”这件事没有 SKILL.md 时你可能会说“把空状态处理一下”但 Agent 不知道空状态是白屏、缺文案还是缺按钮。有 SKILL.md 时说明书里直接写清楚空列表必须显示“暂无记录”删除后必须能撤销撤销后列表必须恢复。Agent 按清单自检再交差你更像在验收而不是反复当人形说明书。收一句工具管“能不能碰到”Skill 管“碰到了按什么标准做”。弱模型救不了但好流程能让强模型少走弯路。3. SKILL.md 四格模板名称、触发、步骤、输出一个最小可用的 SKILL.md 不需要复杂目录规范。一个文件夹里面一份 SKILL.md包含四格名称、触发、步骤、输出。名称用于 Agent 识别和引用触发写清楚什么任务该加载步骤写清先做什么、不做什么输出规定交付格式方便验收。这四个格子比“写漂亮”重要能复用、能改、能触发才是关键。下面是一个“小程序提审自查”模板可以直接抄替换成你的项目名和验收标准# 名称 miniapp-pre-submit-check # 触发 当用户说“开始提审自查”“跑上架前检查”“检查小程序 MVP”时加载本 Skill。 # 步骤 1. 读取当前分支的页面清单列出所有用户可达页面。 2. 对照第一版范围能记、能看、能删改不做电商、社交、支付。 3. 在真机或模拟器走主路径记录白屏、无响应、错文案、死链。 4. 按“未通过条目”逐条修复每次只改一个条目改完重走同一路径。 5. 提审前核对小程序名称、类目、隐私说明是否与实际功能一致。 # 禁止 - 没写清“怎样算过”就报告完成。 - 顺手改无关页面或重构目录。 - 用“感觉差不多”代替验收清单。 - 直接操作生产数据库或提交提审。 # 输出 - 已通过 - 未通过每条附复现步骤、截图描述、影响范围 - 建议下一轮只改 - 风险提示再给一个“修 Bug”的模板适合日常 Agent 修 Bug 时加载# 名称 bugfix-loop # 触发 当用户描述一个可复现 Bug或说“修复这个问题”“按最小改动修”时加载。 # 步骤 1. 先用一句话复述 Bug 现象、复现路径、期望行为。 2. 列出受影响文件和调用链不确定的地方标记待验证。 3. 给出最小修复方案说明为什么这是最小改动。 4. 修改后提供本地验证命令和预期输出。 5. 如果涉及数据变更只生成 SQL 或脚本由用户在本地执行。 # 禁止 - 未经确认就改公共接口或数据库结构。 - 把“可能”“应该”当成已验证结论。 - 一次提交包含多个无关修复。 # 输出 - 现象 - 根因 - 改动文件 - 验证命令 - 验证结果 - 剩余风险这两个模板可以直接复制到你的项目里改成自己的触发词和验收标准。注意这只是说明书骨架真正要自动加载还得按你用的编辑器当前规范调整格式。规则变了说明书也要改。4. TaoToken 接入配置Claude Code、Codex、CC Switch 三套可复制先说共同点Base URL 统一为 https://taotoken.net/apiKey 用 YOUR_API_KEY 占位。先去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentskillmd_config 获取 Key再按工具分别配置。不要把 Claude Code 的 ANTHROPIC_* 环境变量套到 Codex两者协议和变量名不同混用最常见的后果是 401 或模型列表为空。4.1 Claude Codesettings.json 与 ANTHROPIC_*Claude Code 建议在用户级 settings.json 中配置环境变量。路径通常是~/.claude/settings.json。写入{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: claude-sonnet-4-5 } }保存后重启 Claude Code。如果仍然报 401检查三点Key 是否复制完整、Base URL 是否多了末尾斜杠、settings.json 是否被项目级配置覆盖。项目级配置优先级更高可以临时用claude config查看生效值。如果报模型不存在把ANTHROPIC_MODEL换成你账号下可用的模型名或者先留空让工具拉取列表。4.2 Codexconfig.toml 独立配置Codex 使用config.toml不要复用 ANTHROPIC_*。典型配置在~/.codex/config.tomlmodel gpt-5-codex model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key OPENAI_API_KEY wire_api chat然后在终端设置环境变量export OPENAI_API_KEYYOUR_API_KEY如果你在 Windows PowerShell$env:OPENAI_API_KEYYOUR_API_KEYCodex 的报错通常集中在模型名不支持、wire_api 不匹配、base_url 少了 /v1 或多写 /v1。先按上面配置验证再根据 Codex 当期文档调整模型名。修改config.toml后记得完全退出 CLI 再重启避免旧进程读取缓存。4.3 CC Switch 三件套Claude、Codex、通用 OpenAI 兼容如果你用 CC Switch 管理多套配置建议建三个 profile不要混用变量Profile用途关键字段TaoToken-ClaudeClaude CodeANTHROPIC_BASE_URLhttps://taotoken.net/apiANTHROPIC_AUTH_TOKENYOUR_API_KEYTaoToken-CodexCodex CLIbase_urlhttps://taotoken.net/apienv_keyOPENAI_API_KEYTaoToken-OpenAI脚本/其他兼容工具OPENAI_BASE_URLhttps://taotoken.net/apiOPENAI_API_KEYYOUR_API_KEY切换后重启对应 CLI避免旧进程读取缓存。CC Switch 的好处是配置文件不用手改但三套协议要各归各的。Claude Code 走 Anthropic 协议Codex 走 OpenAI 兼容协议通用脚本走标准 OpenAI 变量。只要 Base URL 统一指向https://taotoken.net/apiKey 统一用YOUR_API_KEY替换就能减少大量配置错误。5. 把 SKILL.md 挂进工作流从触发到验收的完整闭环有了模板和配置下一步是让 Agent 在真实任务中触发。以“修 Bug”为例在 Agent 对话中输入“加载 bugfix-loop按最小改动修删除逻辑空状态白屏。”Agent 读取 SKILL.md先复述现象和验收标准。你确认验收标准无误Agent 再进入修改。Agent 输出改动文件、验证命令、剩余风险。你本地执行验证命令把结果贴回对话。这个过程的关键是“先对齐再动手”。没有 SKILL.mdAgent 容易直接改代码改完才发现验收标准不一致。有 SKILL.md触发词一出现步骤和输出格式就固定下来你只需要在关键节点确认。比如 Agent 输出“根因删除后未重置列表状态”你确认后再让它改改完输出“验证命令npm run test:delete”你本地跑一遍把结果贴回去。整个循环比重新口述验收标准短得多。提审自查同理。触发“开始提审自查”Agent 按清单逐条走输出“已通过/未通过/建议下一轮只改”。你验收时看的不是“感觉”而是可复现的条目。返工减少Token 消耗自然下降。如果某个条目反复失败不要急着骂模型先看 SKILL.md 里的步骤是否写得太模糊或者模型能力是否匹配任务。6. 避坑清单弱模型、过时说明书、Skill 堆叠、权限边界第一Skill 救不了弱模型。脑不行说明书再漂亮也会执行歪。如果模型连续两轮无法按步骤执行先检查模型能力是否匹配任务而不是继续加长 SKILL.md。可以把任务拆小或者换一个更擅长工具调用的模型。第二过时说明书等于教坏。小程序规则、接口、提审口径变了Skill 必须跟着改。建议在 SKILL.md 里写“最后更新日期”和“适用范围”每季度或每次平台规则变更后复查。比如提审类目从“工具”调整到“效率”如果说明书没改Agent 仍会按旧类目自检输出结果就是错的。第三Skill 别堆太多。Skill 太多可能抢触发高频场景先做一两个。个人开发者优先固化“修 Bug”“提审自查”“需求拆解”三类其他等稳定后再加。每个 Skill 都要有明确的触发词避免“修 Bug”和“代码审查”互相抢触发。第四权限留一手。Skill 不是乱删库、乱提权的许可证。重要操作比如删除数据、修改生产配置、提交提审必须由你本人确认。涉及数据库变更时让 Agent 只生成 SQL由你在本地执行。不要在 Agent 配置里写入生产库直连也不要把高权限 Key 交给自动执行流程。SKILL.md 可以写“禁止直接操作生产数据库”但最终权限控制要靠工具配置和人工确认。7. 从模型对话到 Coding Plan把返工率降下来的落地路线如果你还没开始建议按这个顺序落地先用模型对话验证一个高频流程比如“修删除逻辑空状态白屏”。模型对话入口https://taotoken.net/models/detail/chat?utm_sourcetaotoken_aicg_blog_endutm_contentskillmd_chat把验证过的流程写成第一版 SKILL.md只保留名称、触发、步骤、输出四格。配置 Claude Code 或 CodexBase URL 指向 https://taotoken.net/apiKey 用 YOUR_API_KEY。如果每天都要用 Agent 修 Bug、做提审自查可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentskillmd_plan创建和管理 Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentskillmd_keysClaude Code 详细配置参考文档https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentskillmd_ccdoc回到最初的问题返工不是因为你不会写提示词而是因为流程没有固化。模型是脑Agent 是手SKILL.md 是把某类活固化成标准动作的说明书。先把一个高频场景写进 SKILL.md再把 Base URL 切到 https://taotoken.net/api观察一周内的返工次数和 Token 消耗。通常你会发现省下来的不是模型费用而是你反复解释验收标准的时间。需要 Key 的话从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentskillmd_end 进入控制台创建即可。