<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
    <channel>
        <title>Codex Skills on 拾光集</title>
        <link>https://www.tood.win/tags/codex-skills/</link>
        <description>Recent content in Codex Skills on 拾光集</description>
        <generator>Hugo -- gohugo.io</generator>
        <language>zh</language>
        <lastBuildDate>Wed, 29 Jul 2026 12:13:49 +0800</lastBuildDate><atom:link href="https://www.tood.win/tags/codex-skills/index.xml" rel="self" type="application/rss+xml" /><item>
            <title>AI 漫剧制作 Skill 工作流：用剧本、资产和分镜提高创作效率</title>
            <link>https://www.tood.win/posts/ai-man-ju-zhi-zuo-skill-gong-zuo-liu-yong/</link>
            <pubDate>Wed, 29 Jul 2026 11:47:00 +0800</pubDate>
            <guid>https://www.tood.win/posts/ai-man-ju-zhi-zuo-skill-gong-zuo-liu-yong/</guid>
            <description>&lt;p&gt;制作 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/ai/&#34; &gt;AI&lt;/a&gt; 漫剧，真正困难的通常不是生成一张图片，而是如何让&lt;strong&gt;剧情节奏、人物形象和镜头衔接保持一致&lt;/strong&gt;。&lt;/p&gt;&#xA;&lt;p&gt;目前 GitHub 上已经出现多套面向 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/claude/&#34; &gt;Claude&lt;/a&gt; Code、&lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/codex/&#34; &gt;Codex&lt;/a&gt; 等 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/ai-agent/&#34; &gt;AI Agent&lt;/a&gt; 的开源 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/skills/&#34; &gt;Skills&lt;/a&gt;。虽然不同项目的命名并不完全相同，但核心流程基本可以归纳为三类：&lt;/p&gt;&#xA;&lt;ol&gt;&#xA;&lt;li&gt;剧本创作 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/skill/&#34; &gt;Skill&lt;/a&gt;&lt;/li&gt;&#xA;&lt;li&gt;图像资产 Skill&lt;/li&gt;&#xA;&lt;li&gt;分镜制作 Skill&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;p&gt;这三类 Skill 可以把小说或创意逐步转换为剧本、角色资产、分镜表和图像或视频提示词。&lt;/p&gt;&#xA;&lt;p&gt;&lt;img alt=&#34;AI 漫剧制作 Skill 工作流：用剧本、资产和分镜提高创作效率&#34; loading=&#34;lazy&#34; sizes=&#34;(max-width: 767px) calc(100vw - 30px), (max-width: 1023px) 700px, (max-width: 1279px) 950px, 1232px&#34; src=&#34;https://www.tood.win/uploads/2026/07/026729_11_43_51-e2394a5a.jpg&#34;&gt;&lt;/p&gt;&#xA;&lt;h2 id=&#34;一剧本创作-skill&#34;&gt;一、剧本创作 Skill&#xA;&lt;/h2&gt;&lt;p&gt;剧本 Skill 负责把小说、故事大纲或简单创意，整理成适合短剧和漫剧制作的结构化剧本。&lt;/p&gt;&#xA;&lt;p&gt;常见输出包括：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;故事背景与核心冲突&lt;/li&gt;&#xA;&lt;li&gt;角色身份、动机和人物关系&lt;/li&gt;&#xA;&lt;li&gt;分集大纲&lt;/li&gt;&#xA;&lt;li&gt;场景编号与场景说明&lt;/li&gt;&#xA;&lt;li&gt;人物动作和对白&lt;/li&gt;&#xA;&lt;li&gt;每集开头的吸引点&lt;/li&gt;&#xA;&lt;li&gt;结尾悬念或下一集钩子&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;它的价值不是单纯“把文字写长”，而是提前解决剧情节奏问题。&lt;/p&gt;&#xA;&lt;p&gt;很多 AI 漫剧画面并不差，但播放数据不理想，常见原因是开头进入剧情太慢、冲突不明确，或者每集结尾缺少继续观看的理由。&lt;/p&gt;&#xA;&lt;p&gt;因此，剧本生成后仍然需要人工检查：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;前几秒是否出现核心事件&lt;/li&gt;&#xA;&lt;li&gt;主角目标是否明确&lt;/li&gt;&#xA;&lt;li&gt;冲突是否能够通过画面表现&lt;/li&gt;&#xA;&lt;li&gt;对白是否过多&lt;/li&gt;&#xA;&lt;li&gt;每个场景是否有存在的必要&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;二图像资产-skill&#34;&gt;二、图像资产 Skill&#xA;&lt;/h2&gt;&lt;p&gt;图像资产 Skill 会从剧本中提取需要反复使用的视觉元素，例如：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;主要角色&lt;/li&gt;&#xA;&lt;li&gt;次要角色&lt;/li&gt;&#xA;&lt;li&gt;服装造型&lt;/li&gt;&#xA;&lt;li&gt;场景&lt;/li&gt;&#xA;&lt;li&gt;道具&lt;/li&gt;&#xA;&lt;li&gt;交通工具&lt;/li&gt;&#xA;&lt;li&gt;特殊物品&lt;/li&gt;&#xA;&lt;li&gt;关键视觉符号&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;随后，它会为每项资产生成结构化说明和图像提示词。&lt;/p&gt;&#xA;&lt;p&gt;一份实用的角色资产档案，至少应包含：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;年龄范围&lt;/li&gt;&#xA;&lt;li&gt;脸型与五官特征&lt;/li&gt;&#xA;&lt;li&gt;发型和发色&lt;/li&gt;&#xA;&lt;li&gt;身材与体态&lt;/li&gt;&#xA;&lt;li&gt;服装款式、颜色和材质&lt;/li&gt;&#xA;&lt;li&gt;常用表情&lt;/li&gt;&#xA;&lt;li&gt;正面、侧面和背面参考&lt;/li&gt;&#xA;&lt;li&gt;中文与英文提示词&lt;/li&gt;&#xA;&lt;li&gt;不允许变化的角色特征&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;这一步的重点是解决**&lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/%e8%a7%92%e8%89%b2%e4%b8%80%e8%87%b4%e6%80%a7/&#34; &gt;角色一致性&lt;/a&gt;**。&lt;/p&gt;&#xA;&lt;p&gt;同一个人物在不同镜头中出现时，应尽量复用相同的角色描述和参考图，而不是每次重新生成一套提示词。否则容易出现脸型、发型、服装颜色和年龄不断变化的问题。&lt;/p&gt;&#xA;&lt;h2 id=&#34;三专业分镜-skill&#34;&gt;三、专业分镜 Skill&#xA;&lt;/h2&gt;&lt;p&gt;分镜 Skill 负责把剧本转换成可以直接执行的镜头清单。&lt;/p&gt;&#xA;&lt;p&gt;它通常会为每个镜头标注：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;镜头编号&lt;/li&gt;&#xA;&lt;li&gt;场景与时间&lt;/li&gt;&#xA;&lt;li&gt;出场人物&lt;/li&gt;&#xA;&lt;li&gt;景别&lt;/li&gt;&#xA;&lt;li&gt;摄影机角度&lt;/li&gt;&#xA;&lt;li&gt;人物位置&lt;/li&gt;&#xA;&lt;li&gt;人物动作&lt;/li&gt;&#xA;&lt;li&gt;表情变化&lt;/li&gt;&#xA;&lt;li&gt;灯光与色调&lt;/li&gt;&#xA;&lt;li&gt;镜头运动&lt;/li&gt;&#xA;&lt;li&gt;台词或旁白&lt;/li&gt;&#xA;&lt;li&gt;建议时长&lt;/li&gt;&#xA;&lt;li&gt;首帧或关键帧提示词&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;例如，剧本中只有一句：&lt;/p&gt;&#xA;&#xA;    &lt;blockquote&gt;&#xA;        &lt;p&gt;主角发现桌上的合同被人替换。&lt;/p&gt;&#xA;&#xA;    &lt;/blockquote&gt;&#xA;&lt;p&gt;分镜需要进一步明确：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;先用近景展示主角翻开合同&lt;/li&gt;&#xA;&lt;li&gt;再切换到合同签名位置的特写&lt;/li&gt;&#xA;&lt;li&gt;主角手指停顿，表情从疑惑变为警觉&lt;/li&gt;&#xA;&lt;li&gt;镜头缓慢推进&lt;/li&gt;&#xA;&lt;li&gt;背景声音逐渐减弱&lt;/li&gt;&#xA;&lt;li&gt;最后切到门外模糊的人影&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;只有完成这样的镜头拆解，图像模型和视频模型才能获得更明确的执行信息。&lt;/p&gt;&#xA;&lt;h2 id=&#34;三类-skill-如何组成完整工作流&#34;&gt;三类 Skill 如何组成完整工作流&#xA;&lt;/h2&gt;&lt;p&gt;一套基础的 AI 漫剧生产流程可以按照下面的顺序执行：&lt;/p&gt;&#xA;&lt;h3 id=&#34;第一步导入故事&#34;&gt;第一步：导入故事&#xA;&lt;/h3&gt;&lt;p&gt;输入小说章节、故事大纲或原创创意，明确：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;视频类型&lt;/li&gt;&#xA;&lt;li&gt;目标平台&lt;/li&gt;&#xA;&lt;li&gt;单集时长&lt;/li&gt;&#xA;&lt;li&gt;画面比例&lt;/li&gt;&#xA;&lt;li&gt;目标观众&lt;/li&gt;&#xA;&lt;li&gt;视觉风格&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;第二步生成分集剧本&#34;&gt;第二步：生成分集剧本&#xA;&lt;/h3&gt;&lt;p&gt;使用剧本 Skill 输出分集大纲和单集剧本，并人工确认剧情逻辑、冲突和结尾钩子。&lt;/p&gt;&#xA;&lt;h3 id=&#34;第三步建立资产库&#34;&gt;第三步：建立资产库&#xA;&lt;/h3&gt;&lt;p&gt;使用资产 Skill 提取角色、场景和道具，先生成角色参考图或三视图。&lt;/p&gt;&#xA;&lt;p&gt;资产确认后再进入批量分镜阶段，避免后期不断返工。&lt;/p&gt;&#xA;&lt;h3 id=&#34;第四步生成分镜&#34;&gt;第四步：生成分镜&#xA;&lt;/h3&gt;&lt;p&gt;使用分镜 Skill 将剧本拆解为逐镜头表格，并生成每个镜头的关键帧提示词。&lt;/p&gt;&#xA;&lt;h3 id=&#34;第五步生成图片和视频&#34;&gt;第五步：生成图片和视频&#xA;&lt;/h3&gt;&lt;p&gt;把已经确认的角色参考图、场景资产和分镜提示词交给图像或视频模型。&lt;/p&gt;&#xA;&lt;p&gt;生成过程中应优先检查：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;人物是否一致&lt;/li&gt;&#xA;&lt;li&gt;服装是否变化&lt;/li&gt;&#xA;&lt;li&gt;场景空间是否连续&lt;/li&gt;&#xA;&lt;li&gt;人物动作能否衔接&lt;/li&gt;&#xA;&lt;li&gt;镜头景别是否过于重复&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;使用-skill-不代表可以完全自动化&#34;&gt;使用 Skill 不代表可以完全自动化&#xA;&lt;/h2&gt;&lt;p&gt;Skill 的作用是把经验和制作规则整理成可重复执行的流程，但它不能自动保证作品质量。&lt;/p&gt;&#xA;&lt;p&gt;实际制作中仍然需要人工完成：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;判断故事是否值得制作&lt;/li&gt;&#xA;&lt;li&gt;修改生硬对白&lt;/li&gt;&#xA;&lt;li&gt;选择最终角色形象&lt;/li&gt;&#xA;&lt;li&gt;检查人物和场景一致性&lt;/li&gt;&#xA;&lt;li&gt;筛选生成结果&lt;/li&gt;&#xA;&lt;li&gt;控制节奏、配音和音乐&lt;/li&gt;&#xA;&lt;li&gt;处理版权及人物肖像风险&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;更准确地说，Skill 能够减少重复整理和提示词编写工作，让创作者把更多时间放在剧情判断和成片质量上。&lt;/p&gt;&#xA;&lt;h2 id=&#34;相关开源项目&#34;&gt;相关开源项目&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-drama-skills&#34;&gt;1. Drama Skills&#xA;&lt;/h3&gt;&lt;p&gt;一套面向 AI 短剧和漫剧制作的 Skills，覆盖故事开发、剧本、资产、&lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/%e5%9b%be%e7%89%87%e6%8f%90%e7%a4%ba%e8%af%8d/&#34; &gt;图片提示词&lt;/a&gt;、分镜、视频提示词和独立审查。&lt;/p&gt;&#xA;&lt;p&gt;GitHub：&lt;/p&gt;&#xA;&lt;p&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/worldwonderer/drama-skills&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;https://github.com/worldwonderer/drama-skills&lt;/a&gt;&lt;/p&gt;&#xA;&lt;p&gt;该项目适配 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/claude-code/&#34; &gt;Claude Code&lt;/a&gt; 和 Codex。目前主要输出结构化文本、资产说明和提示词，不会直接调用图片或视频生成服务。&lt;/p&gt;&#xA;&lt;h3 id=&#34;2-山音超级编剧大师&#34;&gt;2. 山音超级编剧大师&#xA;&lt;/h3&gt;&lt;p&gt;用于短片、电影和多集剧集创作的编剧 Skill，覆盖人物设计、结构大纲、场景拆解和完整剧本。&lt;/p&gt;&#xA;&lt;p&gt;GitHub：&lt;/p&gt;&#xA;&lt;p&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/Shanyin-ai/shanyin-screenwriting-master&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;https://github.com/Shanyin-ai/shanyin-screenwriting-master&lt;/a&gt;&lt;/p&gt;&#xA;&lt;h3 id=&#34;3-山音导演大师&#34;&gt;3. 山音导演大师&#xA;&lt;/h3&gt;&lt;p&gt;负责导演定调、节奏规划、剧本调整和专业分镜拆解，可输出标准分镜表。&lt;/p&gt;&#xA;&lt;p&gt;GitHub：&lt;/p&gt;&#xA;&lt;p&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/Shanyin-ai/shanyin-director-master&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;https://github.com/Shanyin-ai/shanyin-director-master&lt;/a&gt;&lt;/p&gt;&#xA;&lt;h2 id=&#34;总结&#34;&gt;总结&#xA;&lt;/h2&gt;&lt;p&gt;AI 漫剧制作的关键，不是一次生成多少张图片，而是能否建立稳定的生产流程。&lt;/p&gt;&#xA;&lt;p&gt;剧本 Skill 负责解决故事和节奏问题，资产 Skill 负责保持人物与场景一致，分镜 Skill 负责把文字转换为可执行的镜头。&lt;/p&gt;&#xA;&lt;p&gt;将这三类 Skill 串联起来，可以明显减少重复工作，但最终作品是否好看，仍然取决于创作者对剧情、画面和节奏的判断。&lt;/p&gt;&#xA;</description>
        </item><item>
            <title>Cheat on Content：用 AI 预测视频表现，让内容创作从直觉走向数据</title>
            <link>https://www.tood.win/posts/cheat-on-content-yong-ai-yu-ce-shi-pin-biao/</link>
            <pubDate>Tue, 28 Jul 2026 16:14:00 +0800</pubDate>
            <guid>https://www.tood.win/posts/cheat-on-content-yong-ai-yu-ce-shi-pin-biao/</guid>
            <description>&lt;p&gt;做短视频时，最难判断的往往不是“能不能写出来”，而是：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;这个选题值得拍吗？&lt;/li&gt;&#xA;&lt;li&gt;标题有没有吸引力？&lt;/li&gt;&#xA;&lt;li&gt;发布后可能获得多少播放？&lt;/li&gt;&#xA;&lt;li&gt;为什么有些视频表现很好，有些却没有流量？&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;&lt;strong&gt;Cheat on Content&lt;/strong&gt; 是一个开源的 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/ai/&#34; &gt;AI&lt;/a&gt; 内容分析工具。它不会承诺准确预测某条视频一定能获得多少播放量，而是帮助创作者建立一套可以持续校准的内容评估系统。&lt;/p&gt;&#xA;&lt;p&gt;&lt;img alt=&#34;28_11_56_43&#34; loading=&#34;lazy&#34; sizes=&#34;(max-width: 767px) calc(100vw - 30px), (max-width: 1023px) 700px, (max-width: 1279px) 950px, 1232px&#34; src=&#34;https://www.tood.win/uploads/2026/07/28_11_56_43-d6b44f50.png&#34;&gt;&lt;/p&gt;&#xA;&lt;p&gt;它的核心思路是：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;7&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;创作稿件&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;→ 发布前打分&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;→ 记录预测结果&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;→ 发布内容&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;→ 回收真实数据&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;→ 分析预测偏差&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;→ 更新评分规则&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;随着历史样本不断增加，这套系统会越来越了解你的账号，而不是只依赖通用的爆款公式。&lt;/p&gt;&#xA;&lt;h2 id=&#34;cheat-on-content-能做什么&#34;&gt;Cheat on Content 能做什么？&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-发布前评估内容潜力&#34;&gt;1. 发布前评估内容潜力&#xA;&lt;/h3&gt;&lt;p&gt;将视频脚本或文章草稿交给 AI 后，它会根据当前评分规则，对内容进行分析，例如：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;选题是否符合目标受众&lt;/li&gt;&#xA;&lt;li&gt;开头是否能够留住用户&lt;/li&gt;&#xA;&lt;li&gt;标题是否具有点击吸引力&lt;/li&gt;&#xA;&lt;li&gt;内容结构是否清晰&lt;/li&gt;&#xA;&lt;li&gt;评论区是否有讨论空间&lt;/li&gt;&#xA;&lt;li&gt;可能出现哪些传播风险&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;这些分数不是平台官方预测数据，而是基于历史样本和自定义规则得出的参考结果。&lt;/p&gt;&#xA;&lt;h3 id=&#34;2-记录发布前预测&#34;&gt;2. 记录发布前预测&#xA;&lt;/h3&gt;&lt;p&gt;工具会在内容发布前保存预测结果，包括：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;预估播放量区间&lt;/li&gt;&#xA;&lt;li&gt;预期互动表现&lt;/li&gt;&#xA;&lt;li&gt;内容优势&lt;/li&gt;&#xA;&lt;li&gt;潜在问题&lt;/li&gt;&#xA;&lt;li&gt;预测依据&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;发布后再将真实数据导入，避免出现“看到结果后再解释原因”的事后分析。&lt;/p&gt;&#xA;&lt;h3 id=&#34;3-根据真实数据复盘&#34;&gt;3. 根据真实数据复盘&#xA;&lt;/h3&gt;&lt;p&gt;视频发布一段时间后，可以录入实际播放量、点赞、评论、收藏等数据。&lt;/p&gt;&#xA;&lt;p&gt;系统会对比：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;发布前预测结果&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;VS&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;发布后的真实表现&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;然后找出预测偏高或偏低的原因，帮助创作者判断：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;是选题判断错误&lt;/li&gt;&#xA;&lt;li&gt;是标题不够准确&lt;/li&gt;&#xA;&lt;li&gt;是开头留存不足&lt;/li&gt;&#xA;&lt;li&gt;还是账号受众与预期不同&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;4-持续更新评分规则&#34;&gt;4. 持续更新评分规则&#xA;&lt;/h3&gt;&lt;p&gt;当系统连续多次出现同一方向的预测偏差时，会提示调整评分规则。&lt;/p&gt;&#xA;&lt;p&gt;新规则不会直接覆盖旧规则，而是需要重新测试历史样本。只有新规则对过去内容的判断更加准确，才适合继续使用。&lt;/p&gt;&#xA;&lt;p&gt;这让内容评估从一次性的 AI 建议，变成一套能够持续迭代的创作系统。&lt;/p&gt;&#xA;&lt;h2 id=&#34;如何使用-cheat-on-content&#34;&gt;如何使用 Cheat on Content？&#xA;&lt;/h2&gt;&lt;h3 id=&#34;第一步初始化内容项目&#34;&gt;第一步：初始化内容项目&#xA;&lt;/h3&gt;&lt;p&gt;安装完成后，在 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/claude/&#34; &gt;Claude&lt;/a&gt; Code 或 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/codex/&#34; &gt;Codex&lt;/a&gt; 中输入：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;初始化 cheat-on-content&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;工具会询问内容类型、更新频率、账号方向等基础信息，并在项目目录中创建所需文件。&lt;/p&gt;&#xA;&lt;h3 id=&#34;第二步导入历史内容&#34;&gt;第二步：导入历史内容&#xA;&lt;/h3&gt;&lt;p&gt;建议准备至少 5～10 条历史内容作为初始样本，包括：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;表现较好的视频&lt;/li&gt;&#xA;&lt;li&gt;表现一般的视频&lt;/li&gt;&#xA;&lt;li&gt;表现较差的视频&lt;/li&gt;&#xA;&lt;li&gt;对应的标题或文字稿&lt;/li&gt;&#xA;&lt;li&gt;播放量、点赞、评论等数据&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;不要只导入爆款内容。&lt;/p&gt;&#xA;&lt;p&gt;只有同时提供成功和失败样本，AI 才能识别两者之间真正有价值的差异。&lt;/p&gt;&#xA;&lt;h3 id=&#34;第三步分析新稿件&#34;&gt;第三步：分析新稿件&#xA;&lt;/h3&gt;&lt;p&gt;将准备发布的视频脚本保存到项目中，然后让工具进行打分和预测。&lt;/p&gt;&#xA;&lt;p&gt;例如：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;打分这篇 scripts/video-001.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;或：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;启动预测 scripts/video-001.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;AI 会分析稿件并给出修改建议，同时保存发布前预测。&lt;/p&gt;&#xA;&lt;h3 id=&#34;第四步发布并记录结果&#34;&gt;第四步：发布并记录结果&#xA;&lt;/h3&gt;&lt;p&gt;内容发布后，将真实数据录入系统。&lt;/p&gt;&#xA;&lt;p&gt;工具会把实际结果与原始预测进行对比，并生成复盘记录。&lt;/p&gt;&#xA;&lt;h3 id=&#34;第五步升级内容评分规则&#34;&gt;第五步：升级内容评分规则&#xA;&lt;/h3&gt;&lt;p&gt;当历史样本逐渐增加后，系统会根据预测偏差建议更新评分标准。&lt;/p&gt;&#xA;&lt;p&gt;长期使用后，你会得到一套更符合自己账号、赛道和受众的内容判断方法。&lt;/p&gt;&#xA;&lt;h2 id=&#34;这个工具适合哪些人&#34;&gt;这个工具适合哪些人？&#xA;&lt;/h2&gt;&lt;p&gt;Cheat on Content 比较适合：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;短视频创作者&lt;/li&gt;&#xA;&lt;li&gt;自媒体运营人员&lt;/li&gt;&#xA;&lt;li&gt;知识类博主&lt;/li&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/youtube/&#34; &gt;YouTube&lt;/a&gt;、抖音、小红书内容团队&lt;/li&gt;&#xA;&lt;li&gt;需要批量测试选题的企业账号&lt;/li&gt;&#xA;&lt;li&gt;使用 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/claude-code/&#34; &gt;Claude Code&lt;/a&gt; 或 Codex 创作内容的人&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;它尤其适合已经发布过一批内容，但仍然无法总结流量规律的创作者。&lt;/p&gt;&#xA;&lt;h2 id=&#34;使用时需要注意什么&#34;&gt;使用时需要注意什么？&#xA;&lt;/h2&gt;&lt;h3 id=&#34;预测结果不是流量保证&#34;&gt;预测结果不是流量保证&#xA;&lt;/h3&gt;&lt;p&gt;视频播放量还会受到发布时间、平台推荐、账号权重、热点变化、封面、剪辑质量等因素影响。&lt;/p&gt;&#xA;&lt;p&gt;因此，预测分数更适合用于比较多个选题，而不是把某个数字当成最终结果。&lt;/p&gt;&#xA;&lt;h3 id=&#34;初期预测误差可能较大&#34;&gt;初期预测误差可能较大&#xA;&lt;/h3&gt;&lt;p&gt;项目说明中提到，如果没有导入历史对标样本，前几篇内容的预测误差可能较明显。&lt;/p&gt;&#xA;&lt;p&gt;使用时间越长、样本越完整，评分规则才越有参考价值。&lt;/p&gt;&#xA;&lt;h3 id=&#34;数据整理需要一定时间&#34;&gt;数据整理需要一定时间&#xA;&lt;/h3&gt;&lt;p&gt;目前使用过程中，仍需要手动整理脚本和发布数据。&lt;/p&gt;&#xA;&lt;p&gt;对于完全不熟悉终端、Markdown 或 Claude Code 的用户，初次配置会有一定学习成本。&lt;/p&gt;&#xA;&lt;h2 id=&#34;总结&#34;&gt;总结&#xA;&lt;/h2&gt;&lt;p&gt;Cheat on Content 的价值，并不是神奇地算出一条视频能获得多少播放量。&lt;/p&gt;&#xA;&lt;p&gt;它真正解决的问题是：&lt;/p&gt;&#xA;&#xA;    &lt;blockquote&gt;&#xA;        &lt;p&gt;将“我感觉这个选题可能会火”，变成一套有记录、有预测、有结果、有复盘的内容实验流程。&lt;/p&gt;&#xA;&#xA;    &lt;/blockquote&gt;&#xA;&lt;p&gt;对于长期做短视频或自媒体的人来说，单次 AI 改稿并不难，真正困难的是建立稳定的判断标准。&lt;/p&gt;&#xA;&lt;p&gt;Cheat on Content 提供了一种可执行的方法，让每次发布都能为下一次创作积累数据。&lt;/p&gt;&#xA;&lt;h2 id=&#34;github-项目地址&#34;&gt;GitHub 项目地址&#xA;&lt;/h2&gt;&lt;p&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/XBuilderLAB/cheat-on-content&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;Cheat on Content - GitHub&lt;/a&gt;&lt;/p&gt;&#xA;&lt;h3 id=&#34;claude-code-安装&#34;&gt;Claude Code 安装&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;git clone https://github.com/XBuilderLAB/cheat-on-content.git&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nb&#34;&gt;cd&lt;/span&gt; cheat-on-content&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;bash install.sh&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h3 id=&#34;codex-安装&#34;&gt;Codex 安装&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;git clone https://github.com/XBuilderLAB/cheat-on-content.git&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nb&#34;&gt;cd&lt;/span&gt; cheat-on-content&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;bash install.sh --codex&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;安装完成后，建议重新打开 Claude Code 或 Codex 会话，再执行初始化命令。&lt;/p&gt;&#xA;</description>
        </item><item>
            <title>AI Skills 入门教程：用一个 SKILLs.md，让 AI 记住你的工作方法</title>
            <link>https://www.tood.win/posts/ai-skill-ru-men-yong-skill-md-rang-ai-ji/</link>
            <pubDate>Tue, 28 Jul 2026 15:54:00 +0800</pubDate>
            <guid>https://www.tood.win/posts/ai-skill-ru-men-yong-skill-md-rang-ai-ji/</guid>
            <description>&lt;p&gt;每次让 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/ai/&#34; &gt;AI&lt;/a&gt; 写周报、整理会议纪要或分析数据，都要重新解释格式、语气和步骤？&lt;/p&gt;&#xA;&lt;p&gt;这类问题可以通过 &lt;strong&gt;AI &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/skills/&#34; &gt;Skills&lt;/a&gt;&lt;/strong&gt; 解决。&lt;/p&gt;&#xA;&lt;p&gt;Skills 可以理解为写给 AI 的一份“标准操作手册”：它把任务说明、执行规则、参考案例和所需资源整理在一个文件夹中。当用户提出相关需求时，支持 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/agent-skills/&#34; &gt;Agent Skills&lt;/a&gt; 的 AI 工具可以读取并执行这些规则。&lt;/p&gt;&#xA;&#xA;    &lt;blockquote&gt;&#xA;        &lt;p&gt;简单来说：普通提示词只服务于当前对话，Skills 更适合保存可重复使用的工作流程。&lt;/p&gt;&#xA;&#xA;    &lt;/blockquote&gt;&#xA;&lt;p&gt;&lt;img alt=&#34;b664215f-a0ce-4e20-ab85-487201475799&#34; loading=&#34;lazy&#34; sizes=&#34;(max-width: 767px) calc(100vw - 30px), (max-width: 1023px) 700px, (max-width: 1279px) 950px, 1232px&#34; src=&#34;https://www.tood.win/uploads/2026/07/b664215f-a0ce-4e20-ab85-487201475799-5b21eb99.jpg&#34;&gt;&lt;/p&gt;&#xA;&lt;h2 id=&#34;skills-是什么&#34;&gt;Skills 是什么？&#xA;&lt;/h2&gt;&lt;p&gt;一个 Skills 通常对应一项明确任务，例如：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;根据工作记录生成周报&lt;/li&gt;&#xA;&lt;li&gt;按固定标准审核文章&lt;/li&gt;&#xA;&lt;li&gt;整理会议纪要并提取待办事项&lt;/li&gt;&#xA;&lt;li&gt;检查代码中的安全问题&lt;/li&gt;&#xA;&lt;li&gt;按品牌规范生成营销文案&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;官方 Agent Skills 规范将 Skills 定义为一种轻量级开放格式。最基础的 Skills 是一个文件夹，其中必须包含 &lt;code&gt;Skills.md&lt;/code&gt;；复杂 Skills 还可以附带脚本、模板、示例和参考资料。&lt;/p&gt;&#xA;&lt;h2 id=&#34;skills-能解决什么问题&#34;&gt;Skills 能解决什么问题？&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-减少重复沟通&#34;&gt;1. 减少重复沟通&#xA;&lt;/h3&gt;&lt;p&gt;不需要每次都重新说明：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;输出包含哪些栏目&lt;/li&gt;&#xA;&lt;li&gt;使用什么语气&lt;/li&gt;&#xA;&lt;li&gt;哪些内容不能出现&lt;/li&gt;&#xA;&lt;li&gt;数据应该如何展示&lt;/li&gt;&#xA;&lt;li&gt;最终结果采用什么格式&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;2-统一输出标准&#34;&gt;2. 统一输出标准&#xA;&lt;/h3&gt;&lt;p&gt;多人或多次使用同一个 Skills 时，可以尽量保持相同的结构、流程和判断标准。&lt;/p&gt;&#xA;&lt;h3 id=&#34;3-沉淀个人工作方法&#34;&gt;3. 沉淀个人工作方法&#xA;&lt;/h3&gt;&lt;p&gt;当你发现一套提示词效果很好，可以把它整理成 Skills，而不是让它一直留在聊天记录中。&lt;/p&gt;&#xA;&lt;p&gt;需要注意的是，Skills 并不是让 AI 获得真正的“永久记忆”。它更像一份保存在本地或项目目录中的规则文件：只有工具能够发现并加载它时，规则才会生效。&lt;/p&gt;&#xA;&lt;h2 id=&#34;skills-的基本目录结构&#34;&gt;Skills 的基本目录结构&#xA;&lt;/h2&gt;&lt;p&gt;一个标准 Skills 不只是单独散落的文本文件，而是一个独立文件夹：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;6&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;weekly-report/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── Skills.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── references/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;│   └── report-example.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;└── templates/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;    └── weekly-report-template.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;其中：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;code&gt;Skills.md&lt;/code&gt;：必需，写明名称、用途和执行规则&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;references/&lt;/code&gt;：可选，存放参考资料或优秀案例&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;templates/&lt;/code&gt;：可选，存放固定模板&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;scripts/&lt;/code&gt;：可选，存放需要执行的辅助脚本&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;Anthropic 和 OpenAI 的官方文档都将 Skills 描述为包含指令、资源以及可选脚本的任务能力包，而不只是一个简单提示词。&lt;/p&gt;&#xA;&lt;h2 id=&#34;三步写出第一个-skills&#34;&gt;三步写出第一个 Skills&#xA;&lt;/h2&gt;&lt;p&gt;下面以“周报助手”为例。&lt;/p&gt;&#xA;&lt;h3 id=&#34;第一步写清楚名称和触发条件&#34;&gt;第一步：写清楚名称和触发条件&#xA;&lt;/h3&gt;&lt;p&gt;在 &lt;code&gt;Skills.md&lt;/code&gt; 顶部加入 YAML 元数据：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;4&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-md&#34; data-lang=&#34;md&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;---&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;name: weekly-report&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;description: 根据用户提供的本周工作记录生成中文周报。当用户要求写周报、整理本周工作，或提交一组工作记录时使用。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;---&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;至少应写清楚：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;code&gt;name&lt;/code&gt;：Skills 的名称&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;description&lt;/code&gt;：它能做什么，以及什么时候应该使用&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;&lt;code&gt;description&lt;/code&gt; 不要只写“处理文档”或“提高效率”，否则 AI 很难判断什么时候需要调用它。&lt;/p&gt;&#xA;&lt;h3 id=&#34;第二步把要求改成可执行规则&#34;&gt;第二步：把要求改成可执行规则&#xA;&lt;/h3&gt;&lt;p&gt;不要只写：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;写得专业一点。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;内容简洁一些。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;这种描述过于主观，不同模型可能有不同理解。&lt;/p&gt;&#xA;&lt;p&gt;可以改成：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt; 1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 7&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 8&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 9&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;10&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;11&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;12&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;13&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;14&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;15&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;16&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;17&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;18&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;19&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;20&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;21&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;22&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;23&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;24&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;25&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-md&#34; data-lang=&#34;md&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gh&#34;&gt;# 周报生成规则&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;收到用户的工作记录后，按以下顺序处理：&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;1.&lt;/span&gt; 将内容分为：&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;   &lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 本周完成&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;   &lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 进行中&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;   &lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 下周计划&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;2.&lt;/span&gt; 每条内容优先保留：&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;   &lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 项目名称&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;   &lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 完成数量&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;   &lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 当前进度&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;   &lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 产生的结果&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;   &lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 后续动作&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;3.&lt;/span&gt; 不得虚构用户未提供的数据。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;4.&lt;/span&gt; 没有具体数字时，保留原始事实，并注明“未提供量化数据”。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;5.&lt;/span&gt; 删除“积极推进”“持续赋能”“圆满完成”等空泛表达。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;6.&lt;/span&gt; 每条控制在两句话以内。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;7.&lt;/span&gt; 最后增加一段不超过80字的本周总结。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;这些规则能够直接执行，也更容易检查结果是否合格。&lt;/p&gt;&#xA;&lt;h3 id=&#34;第三步提供输入与输出示例&#34;&gt;第三步：提供输入与输出示例&#xA;&lt;/h3&gt;&lt;p&gt;示例能帮助 AI 理解你真正想要的效果。&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt; 1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 7&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 8&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 9&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;10&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;11&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;12&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;13&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;14&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;15&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;16&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;17&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;18&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;19&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;20&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;21&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;22&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;23&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;24&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;25&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;26&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;27&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;28&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-md&#34; data-lang=&#34;md&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gh&#34;&gt;# 示例&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 输入&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 完成用户调研&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 修复了几个登录页面的问题&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 数据看板还在调整&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 下周准备上线新活动&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 输出&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;### 本周完成&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;1.&lt;/span&gt; 完成用户调研，共收集326份有效问卷，并整理出15条核心反馈。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;2.&lt;/span&gt; 修复登录页面3个影响用户使用的问题，登录功能已通过测试。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;### 进行中&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;1.&lt;/span&gt; 数据看板重构已完成约60%，预计下周完成剩余图表和筛选功能。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;### 下周计划&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;1.&lt;/span&gt; 完成数据看板重构并提交测试。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;2.&lt;/span&gt; 上线新用户活动，持续跟踪访问量和注册转化率。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;### 本周总结&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;本周重点完成用户调研和登录功能修复，数据看板重构按计划推进，下周将进入功能上线和数据验证阶段。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;示例越接近真实工作场景，输出通常越稳定。&lt;/p&gt;&#xA;&lt;h2 id=&#34;可直接复制的完整-skillsmd&#34;&gt;可直接复制的完整 Skills.md&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt; 1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 7&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 8&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 9&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;10&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;11&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;12&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;13&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;14&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;15&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;16&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;17&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;18&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;19&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;20&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;21&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;22&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;23&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;24&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;25&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;26&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;27&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;28&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;29&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;30&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;31&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;32&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;33&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;34&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;35&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;36&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;37&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;38&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;39&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;40&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;41&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;42&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;43&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;44&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;45&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;46&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;47&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;48&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;49&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;50&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;51&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;52&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;53&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;54&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;55&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;56&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;57&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;58&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;59&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;60&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;61&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;62&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;63&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;64&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;65&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;66&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;67&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;68&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;69&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;70&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;71&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;72&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;73&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;74&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;75&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-md&#34; data-lang=&#34;md&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;---&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;name: weekly-report&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;description: 根据用户提供的工作记录生成结构清晰的中文周报。当用户要求写周报、总结本周工作或发送零散工作记录时使用。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;---&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gh&#34;&gt;# 周报助手&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 目标&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;将用户提供的零散工作记录整理为可以直接发送的中文周报。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 执行步骤&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;1.&lt;/span&gt; 阅读全部工作记录。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;2.&lt;/span&gt; 合并重复事项。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;3.&lt;/span&gt; 按“本周完成、进行中、下周计划”分类。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;4.&lt;/span&gt; 保留项目名称、数量、进度、结果和下一步动作。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;5.&lt;/span&gt; 生成结构清晰的 Markdown 周报。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 输出结构&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;### 本周完成&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;列出已经完成并产生结果的事项。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;### 进行中&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;列出尚未完成的任务，并说明当前进度和下一步动作。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;### 下周计划&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;列出下周需要执行的具体任务。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;### 本周总结&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;使用不超过80字总结本周重点、进展和风险。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 写作规则&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 使用平实、清晰的中文。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 每条内容不超过两句话。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 优先使用具体数字、进度和结果。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 不使用“积极推进”“持续赋能”“圆满完成”等空泛表达。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 不得编造用户没有提供的信息。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 信息不足时，保留原意并注明缺少的数据。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 默认使用 Markdown 格式。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 示例&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;输入：&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 完成客户调研&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 修复登录页面问题&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 看板还在调整&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 下周上线活动&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;输出：&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;### 本周完成&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;1.&lt;/span&gt; 完成客户调研，并整理主要需求和反馈。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;2.&lt;/span&gt; 完成登录页面问题修复，相关功能已恢复正常。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;### 进行中&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;1.&lt;/span&gt; 数据看板仍在调整，下一步将完善图表和筛选功能。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;### 下周计划&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;1.&lt;/span&gt; 完成数据看板调整并提交测试。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;2.&lt;/span&gt; 上线新活动并跟踪用户参与数据。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;### 本周总结&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;本周完成客户调研和登录问题修复，数据看板正在推进，下周重点为活动上线和数据验证。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h2 id=&#34;新手常见的三个错误&#34;&gt;新手常见的三个错误&#xA;&lt;/h2&gt;&lt;h3 id=&#34;触发条件太模糊&#34;&gt;触发条件太模糊&#xA;&lt;/h3&gt;&lt;p&gt;错误写法：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;用于处理工作。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;推荐写法：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;当用户要求生成周报，或提交本周工作记录时使用。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h3 id=&#34;规则只有形容词&#34;&gt;规则只有形容词&#xA;&lt;/h3&gt;&lt;p&gt;错误写法：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;写得专业、简洁、有深度。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;推荐写法：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;正文不超过500字，每条不超过两句话，每项至少保留一个结果或进度信息。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h3 id=&#34;一个-skills-承担太多任务&#34;&gt;一个 Skills 承担太多任务&#xA;&lt;/h3&gt;&lt;p&gt;不建议把“写周报、做PPT、分析数据、发送邮件”全部放进同一个 Skills。&lt;/p&gt;&#xA;&lt;p&gt;更合理的方式是拆成多个独立 Skills：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;4&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;weekly-report/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;meeting-notes/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;data-analysis/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;email-reply/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;一个 Skills 只解决一类明确问题，通常更容易触发，也更方便维护。&lt;/p&gt;&#xA;&lt;h2 id=&#34;使用第三方-skills-前要注意什么&#34;&gt;使用第三方 Skills 前要注意什么？&#xA;&lt;/h2&gt;&lt;p&gt;不要看到 GitHub 上的 Skills 就直接安装。&lt;/p&gt;&#xA;&lt;p&gt;第三方 Skills 可能附带脚本、命令或外部资源。使用前至少检查：&lt;/p&gt;&#xA;&lt;ol&gt;&#xA;&lt;li&gt;&lt;code&gt;Skills.md&lt;/code&gt; 要求 AI 执行哪些操作&lt;/li&gt;&#xA;&lt;li&gt;是否包含 &lt;code&gt;scripts/&lt;/code&gt; 等可执行文件&lt;/li&gt;&#xA;&lt;li&gt;是否会读取环境变量、密钥或私人文件&lt;/li&gt;&#xA;&lt;li&gt;是否要求上传数据到外部服务&lt;/li&gt;&#xA;&lt;li&gt;GitHub 仓库是否持续维护&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;p&gt;研究已经指出，Agent Skills 生态存在指令注入、恶意脚本和供应链风险，因此第三方 Skills 应当像第三方代码一样审查，而不是只把它当作文档。&lt;/p&gt;&#xA;&lt;h2 id=&#34;去哪里找现成的-skills&#34;&gt;去哪里找现成的 Skills？&#xA;&lt;/h2&gt;&lt;p&gt;可以从以下官方项目开始：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://developers.openai.com/codex/Skills&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;OpenAI Codex Agent Skills 文档&lt;/a&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/anthropics/Skills&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;Anthropic 官方 Skills 仓库&lt;/a&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/agentSkills/agentSkills&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;Agent Skills 开放规范&lt;/a&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/topics/agent-Skills&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;GitHub Agent Skills 专题&lt;/a&gt;&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;建议先阅读官方示例，再根据自己的工作流程修改。不要直接复制一个功能复杂的 Skills，然后期待它完全符合自己的需求。&lt;/p&gt;&#xA;&lt;h2 id=&#34;总结&#34;&gt;总结&#xA;&lt;/h2&gt;&lt;p&gt;写 Skills 的关键，不是堆积大量提示词，而是把一项任务说明清楚：&lt;/p&gt;&#xA;&lt;ol&gt;&#xA;&lt;li&gt;&lt;strong&gt;什么时候使用&lt;/strong&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;按什么步骤执行&lt;/strong&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;必须遵守哪些规则&lt;/strong&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;最终输出什么格式&lt;/strong&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;什么样的结果才算合格&lt;/strong&gt;&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;p&gt;第一次可以从最常用、最重复的一项任务开始，例如周报、会议纪要或文章审核。先完成一个简单可用的版本，再根据实际输出逐步补充规则和示例。&lt;/p&gt;&#xA;</description>
        </item><item>
            <title>5个自定义 Skills，让 Codex 从代码生成器升级为全能 AI 开发助手</title>
            <link>https://www.tood.win/posts/5-ge-zi-ding-yi-skill-rang-codex-cong-dai/</link>
            <pubDate>Tue, 28 Jul 2026 11:34:00 +0800</pubDate>
            <guid>https://www.tood.win/posts/5-ge-zi-ding-yi-skill-rang-codex-cong-dai/</guid>
            <description>&lt;p&gt;很多人使用 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/codex/&#34; &gt;Codex&lt;/a&gt; 时，只让它完成“写代码”这一件事。&lt;/p&gt;&#xA;&lt;p&gt;遇到需求就生成代码，出现报错再继续修改。这样的使用方式虽然方便，但 Codex 很难理解项目背景，也容易出现需求理解偏差、界面模板化、修改范围过大等问题。&lt;/p&gt;&#xA;&lt;p&gt;更有效的方法，是通过 &lt;strong&gt;&lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/agent-skills/&#34; &gt;Agent Skills&lt;/a&gt;&lt;/strong&gt; 为 Codex 增加固定的知识、规则和工作流程。&lt;/p&gt;&#xA;&lt;p&gt;Skill 本质上是一组可重复使用的说明、脚本和资源。它可以让 Codex 在执行特定任务时，按照预先设定的流程工作，而不是每次都依赖临时提示词。OpenAI 的 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/skills/&#34; &gt;Skills&lt;/a&gt; 项目也将其定义为帮助 Codex 扩展专业能力的模块化目录。&lt;sup id=&#34;fnref:1&#34;&gt;&lt;a href=&#34;#fn:1&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;1&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#xA;&lt;p&gt;下面这 5 个 Skill，分别解决知识管理、方案审查、UI 设计、中文写作和代码质量问题。&lt;/p&gt;&#xA;&lt;p&gt;&lt;img alt=&#34;2026728_11_32_01&#34; loading=&#34;lazy&#34; sizes=&#34;(max-width: 767px) calc(100vw - 30px), (max-width: 1023px) 700px, (max-width: 1279px) 950px, 1232px&#34; src=&#34;https://www.tood.win/uploads/2026/07/2026728_11_32_01-2bd2a234.jpg&#34;&gt;&lt;/p&gt;&#xA;&lt;h2 id=&#34;一obsidian-skills把-obsidian-变成-codex-的知识库&#34;&gt;一、obsidian-skills：把 Obsidian 变成 Codex 的知识库&#xA;&lt;/h2&gt;&lt;p&gt;在长期项目中，真正影响 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/ai/&#34; &gt;AI&lt;/a&gt; 工作质量的往往不是模型能力，而是它不知道你之前做过什么。&lt;/p&gt;&#xA;&lt;p&gt;例如：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;项目已经确定了哪些技术方案&lt;/li&gt;&#xA;&lt;li&gt;哪些错误曾经出现过&lt;/li&gt;&#xA;&lt;li&gt;用户有哪些固定偏好&lt;/li&gt;&#xA;&lt;li&gt;某项设计为什么被放弃&lt;/li&gt;&#xA;&lt;li&gt;当前项目有哪些待办事项&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;&lt;code&gt;obsidian-skills&lt;/code&gt; 可以让 Codex 读取和管理 Obsidian 知识库中的 Markdown 笔记、任务、属性、Bases 和 JSON Canvas。&lt;/p&gt;&#xA;&lt;p&gt;该项目遵循 Agent Skills 规范，并明确支持 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/codex-cli/&#34; &gt;Codex CLI&lt;/a&gt; 等兼容 Skills 的 AI 编程工具。&lt;sup id=&#34;fnref:2&#34;&gt;&lt;a href=&#34;#fn:2&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;2&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#xA;&lt;h3 id=&#34;它能解决什么问题&#34;&gt;它能解决什么问题&#xA;&lt;/h3&gt;&lt;p&gt;使用这个 Skill 后，可以让 Codex：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;搜索 Obsidian 中的历史笔记&lt;/li&gt;&#xA;&lt;li&gt;创建和更新项目文档&lt;/li&gt;&#xA;&lt;li&gt;整理零散的开发记录&lt;/li&gt;&#xA;&lt;li&gt;查找与当前任务相关的内容&lt;/li&gt;&#xA;&lt;li&gt;将解决方案沉淀为长期知识&lt;/li&gt;&#xA;&lt;li&gt;根据历史记录继续未完成的工作&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;适合的使用场景&#34;&gt;适合的使用场景&#xA;&lt;/h3&gt;&lt;p&gt;例如你可以告诉 Codex：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;搜索 Obsidian 中与当前网站部署有关的笔记，&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;整理已经尝试过的方法、失败原因和最终解决方案，&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;然后根据这些信息继续排查问题。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;这样可以减少重复解释项目背景，也能避免 AI 再次尝试已经失败的方法。&lt;/p&gt;&#xA;&#xA;    &lt;blockquote&gt;&#xA;        &lt;p&gt;需要注意：它主要负责帮助 AI 操作和整理 Obsidian 知识库，并不等于自动拥有完整的长期记忆。最终效果仍取决于你的笔记结构和记录质量。&lt;/p&gt;&#xA;&#xA;    &lt;/blockquote&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;二ui-skill减少-ai-生成网页的模板感&#34;&gt;二、UI Skill：减少 AI 生成网页的模板感&#xA;&lt;/h2&gt;&lt;p&gt;AI 可以快速生成网页，但生成结果经常存在明显的“AI 模板感”。&lt;/p&gt;&#xA;&lt;p&gt;常见问题包括：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;不分场景地使用紫蓝渐变&lt;/li&gt;&#xA;&lt;li&gt;所有内容都居中排列&lt;/li&gt;&#xA;&lt;li&gt;页面由大量相似卡片组成&lt;/li&gt;&#xA;&lt;li&gt;默认使用常见字体和圆角&lt;/li&gt;&#xA;&lt;li&gt;只考虑桌面端，没有检查移动端&lt;/li&gt;&#xA;&lt;li&gt;视觉效果不错，但真实上线后不好使用&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;UI Skill 的作用不是提供一个固定模板，而是给 Codex 增加一套设计判断标准。&lt;/p&gt;&#xA;&lt;p&gt;目前 GitHub 上已经有多种面向 Codex 的 UI Skills。例如 &lt;code&gt;ui-ux-pro-max-skill&lt;/code&gt; 提供了 UI 风格、配色、字体组合、产品类型、UX 规则和图表类型等设计知识，可用于网页和移动端界面的规划、生成、审查与优化。&lt;sup id=&#34;fnref:3&#34;&gt;&lt;a href=&#34;#fn:3&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;3&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#xA;&lt;h3 id=&#34;1-建立设计黑名单&#34;&gt;1. 建立设计黑名单&#xA;&lt;/h3&gt;&lt;p&gt;可以在 Skill 中明确禁止一些容易产生模板感的设计：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;7&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;8&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;除非项目明确要求，否则不要默认使用：&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;- 紫色到蓝色的渐变背景&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;- 所有标题和内容居中对齐&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;- 大量相同尺寸的信息卡片&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;- 缺乏层级的圆角矩形&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;- 没有业务含义的装饰性光效&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;- 默认套用科技 SaaS 网站风格&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;设计黑名单并不是完全禁止这些元素，而是要求 Codex 在使用前说明理由。&lt;/p&gt;&#xA;&lt;h3 id=&#34;2-根据业务选择设计语言&#34;&gt;2. 根据业务选择设计语言&#xA;&lt;/h3&gt;&lt;p&gt;品牌官网、个人博客和后台管理系统，不应该使用完全相同的设计方式。&lt;/p&gt;&#xA;&lt;p&gt;Skill 可以要求 Codex先判断页面类型：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;  &lt;thead&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;th&gt;页面类型&lt;/th&gt;&#xA;          &lt;th&gt;设计重点&lt;/th&gt;&#xA;      &lt;/tr&gt;&#xA;  &lt;/thead&gt;&#xA;  &lt;tbody&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;品牌落地页&lt;/td&gt;&#xA;          &lt;td&gt;品牌识别、视觉节奏、转化路径&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;个人博客&lt;/td&gt;&#xA;          &lt;td&gt;阅读体验、内容层级、页面速度&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;后台系统&lt;/td&gt;&#xA;          &lt;td&gt;信息密度、操作效率、状态反馈&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;电商页面&lt;/td&gt;&#xA;          &lt;td&gt;商品信息、信任感、购买路径&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;工具网站&lt;/td&gt;&#xA;          &lt;td&gt;功能入口、操作引导、结果展示&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;  &lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h3 id=&#34;3-增加上线前质检&#34;&gt;3. 增加上线前质检&#xA;&lt;/h3&gt;&lt;p&gt;页面完成后，要求 Codex 检查：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;手机端图片是否变形&lt;/li&gt;&#xA;&lt;li&gt;长英文和链接是否可以换行&lt;/li&gt;&#xA;&lt;li&gt;按钮是否有明确反馈&lt;/li&gt;&#xA;&lt;li&gt;文字对比度是否足够&lt;/li&gt;&#xA;&lt;li&gt;页面加载是否依赖过大的图片&lt;/li&gt;&#xA;&lt;li&gt;表单是否提供错误提示&lt;/li&gt;&#xA;&lt;li&gt;页面是否存在横向溢出&lt;/li&gt;&#xA;&lt;li&gt;键盘操作是否正常&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;这样可以让 Codex 从“生成一个好看的页面”，升级为“交付一个可以实际使用的页面”。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;三humanizer-zh减少中文内容的-ai-味&#34;&gt;三、Humanizer-zh：减少中文内容的 AI 味&#xA;&lt;/h2&gt;&lt;p&gt;Codex 不只能写代码，也经常被用于生成：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;产品介绍&lt;/li&gt;&#xA;&lt;li&gt;README 文档&lt;/li&gt;&#xA;&lt;li&gt;博客文章&lt;/li&gt;&#xA;&lt;li&gt;更新日志&lt;/li&gt;&#xA;&lt;li&gt;网站文案&lt;/li&gt;&#xA;&lt;li&gt;操作说明&lt;/li&gt;&#xA;&lt;li&gt;社交媒体内容&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;但 AI 生成的中文常常存在表达生硬、结构重复和营销感过强的问题。&lt;/p&gt;&#xA;&lt;p&gt;&lt;code&gt;Humanizer-zh&lt;/code&gt; 是一个中文内容优化 Skill，主要用于识别并减少 AI 写作痕迹，让文字更自然、更接近真实中文表达。其项目说明中明确提到，它可以用于编辑或审阅 AI 生成的文本。&lt;sup id=&#34;fnref:4&#34;&gt;&lt;a href=&#34;#fn:4&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;4&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#xA;&lt;h3 id=&#34;常见的-ai-写作问题&#34;&gt;常见的 AI 写作问题&#xA;&lt;/h3&gt;&lt;p&gt;它可以重点检查以下内容：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;频繁使用“值得注意的是”&lt;/li&gt;&#xA;&lt;li&gt;每段都使用相同句式&lt;/li&gt;&#xA;&lt;li&gt;过度使用“赋能”“重塑”“开启新篇章”&lt;/li&gt;&#xA;&lt;li&gt;没有事实支撑的夸张表达&lt;/li&gt;&#xA;&lt;li&gt;大量使用“首先、其次、最后”&lt;/li&gt;&#xA;&lt;li&gt;句子看似完整，但缺少具体信息&lt;/li&gt;&#xA;&lt;li&gt;中文中出现明显的英文翻译腔&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;使用示例&#34;&gt;使用示例&#xA;&lt;/h3&gt;&lt;p&gt;完成网站文章后，可以让 Codex 执行：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;7&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;8&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;使用 Humanizer-zh 检查这篇文章。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;要求：&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;1. 删除空泛和夸张的营销表达；&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;2. 保留技术事实、命令和项目名称；&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;3. 调整重复句式；&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;4. 使用自然、简洁的中文；&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;5. 不要为了口语化而降低专业性。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;它适合作为内容发布前的最后一道编辑流程，而不是简单地把所有内容改成口语。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;四grill-me在开发之前先把方案问清楚&#34;&gt;四、grill-me：在开发之前先把方案问清楚&#xA;&lt;/h2&gt;&lt;p&gt;AI 编程最常见的问题之一，是需求还没有明确，AI 就已经开始写代码。&lt;/p&gt;&#xA;&lt;p&gt;结果通常是：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;技术路线选择错误&lt;/li&gt;&#xA;&lt;li&gt;功能边界不断扩大&lt;/li&gt;&#xA;&lt;li&gt;忽略重要异常情况&lt;/li&gt;&#xA;&lt;li&gt;修改大量无关文件&lt;/li&gt;&#xA;&lt;li&gt;做完以后才发现需求理解错了&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;&lt;code&gt;grill-me&lt;/code&gt; 的作用，就是在动手开发前扮演一个严格的方案审查者。&lt;/p&gt;&#xA;&lt;p&gt;该 Skill 会围绕计划、设计或技术方案持续追问，直到关键决策、假设和分支得到明确。&lt;sup id=&#34;fnref:5&#34;&gt;&lt;a href=&#34;#fn:5&#34; class=&#34;footnote-ref&#34; role=&#34;doc-noteref&#34;&gt;5&lt;/a&gt;&lt;/sup&gt;&lt;/p&gt;&#xA;&lt;h3 id=&#34;它会重点追问什么&#34;&gt;它会重点追问什么&#xA;&lt;/h3&gt;&lt;p&gt;例如开发一个用户登录功能时，&lt;code&gt;grill-me&lt;/code&gt; 不会立刻生成代码，而是先检查：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;使用邮箱、手机号还是第三方账号登录&lt;/li&gt;&#xA;&lt;li&gt;是否需要注册、找回密码和邮箱验证&lt;/li&gt;&#xA;&lt;li&gt;登录状态保存多久&lt;/li&gt;&#xA;&lt;li&gt;是否允许多设备同时登录&lt;/li&gt;&#xA;&lt;li&gt;失败次数是否需要限制&lt;/li&gt;&#xA;&lt;li&gt;用户数据存储在哪里&lt;/li&gt;&#xA;&lt;li&gt;哪些页面需要登录后访问&lt;/li&gt;&#xA;&lt;li&gt;是否存在管理员和普通用户权限&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;推荐使用阶段&#34;&gt;推荐使用阶段&#xA;&lt;/h3&gt;&lt;p&gt;&lt;code&gt;grill-me&lt;/code&gt; 最适合在以下阶段使用：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;新功能开发之前&lt;/li&gt;&#xA;&lt;li&gt;数据库结构确定之前&lt;/li&gt;&#xA;&lt;li&gt;API 接口设计之前&lt;/li&gt;&#xA;&lt;li&gt;大规模重构之前&lt;/li&gt;&#xA;&lt;li&gt;技术方案评审之前&lt;/li&gt;&#xA;&lt;li&gt;项目需求仍然比较模糊时&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;使用示例-1&#34;&gt;使用示例&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt; 1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 7&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 8&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 9&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;10&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;11&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;使用 grill-me 审查下面的开发方案。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;在需求和边界没有明确之前，不要编写代码。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;请重点检查：&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;- 隐含假设&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;- 异常流程&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;- 数据安全&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;- 权限设计&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;- 技术复杂度&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;- 后期维护成本&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;这个 Skill 看起来会让前期讨论变慢，但通常能减少后期返工。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;五编码原则-skill限制-codex-的修改范围&#34;&gt;五、编码原则 Skill：限制 Codex 的修改范围&#xA;&lt;/h2&gt;&lt;p&gt;前面四个 Skill 解决了知识、方案、设计和内容问题，最后还需要一套编码原则来限制 Codex 的执行行为。&lt;/p&gt;&#xA;&lt;p&gt;这部分不一定需要安装现成项目，也可以根据自己的开发习惯创建一个自定义 &lt;code&gt;SKILL.md&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;h3 id=&#34;推荐的核心原则&#34;&gt;推荐的核心原则&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt; 1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 7&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 8&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 9&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;10&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;11&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;12&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;13&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;14&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;15&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;16&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;17&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;18&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;19&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;20&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;21&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;22&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;23&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;24&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;25&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;26&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;27&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;28&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;29&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;30&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;31&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;32&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;33&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;34&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;35&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;36&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;37&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;38&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;39&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;40&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;41&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;42&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;43&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;44&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;45&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;46&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;47&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;48&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;49&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;50&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;51&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;52&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;53&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;54&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;55&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;56&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;57&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;58&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-markdown&#34; data-lang=&#34;markdown&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gh&#34;&gt;# 编码原则&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 1. 不猜测需求&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;需求不明确时，先检查现有代码、文档和配置。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;如果仍然无法确定，应明确说明假设，不要把猜测当成事实。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 2. 只做最小必要修改&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;只修改完成当前任务必需的文件。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;不要顺便重构无关代码，不要更改没有问题的目录结构。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 3. 不擅自增加抽象&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;没有明确复用需求时，不新增：&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 通用工具层&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 复杂设计模式&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 多余的配置系统&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 不必要的第三方依赖&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;优先使用项目现有结构和原生能力。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 4. 保持原有代码风格&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;修改前先检查：&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 命名规则&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 目录结构&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 格式化配置&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 错误处理方式&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 测试写法&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 已使用的组件和依赖&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;新增代码应与现有项目保持一致。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 5. 修改后必须验证&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;完成修改后至少执行：&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 类型检查&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 语法检查&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 相关测试&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 构建检查&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 修改内容复核&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;如果无法执行某项验证，需要明确说明原因。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## 6. 不隐藏问题&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;不要通过删除测试、关闭类型检查、忽略错误或使用空异常处理来让任务表面通过。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;发现现有问题时，应区分：&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 本次修改引入的问题&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; 项目原本存在的问题&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;这套规则的重点不是让 Codex 少写代码，而是让每次修改都更可预测、更容易审查。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;五个-skill-如何组成完整工作流&#34;&gt;五个 Skill 如何组成完整工作流&#xA;&lt;/h2&gt;&lt;p&gt;这五个 Skill 并不是相互独立的工具，可以按照开发流程组合使用。&lt;/p&gt;&#xA;&lt;h3 id=&#34;第一步读取历史知识&#34;&gt;第一步：读取历史知识&#xA;&lt;/h3&gt;&lt;p&gt;使用 &lt;code&gt;obsidian-skills&lt;/code&gt; 搜索项目笔记、历史方案和踩坑记录。&lt;/p&gt;&#xA;&lt;h3 id=&#34;第二步审查需求&#34;&gt;第二步：审查需求&#xA;&lt;/h3&gt;&lt;p&gt;使用 &lt;code&gt;grill-me&lt;/code&gt; 挑战需求和技术方案，找出缺失信息与边界情况。&lt;/p&gt;&#xA;&lt;h3 id=&#34;第三步设计并实现界面&#34;&gt;第三步：设计并实现界面&#xA;&lt;/h3&gt;&lt;p&gt;使用 UI Skill 确定设计语言、页面结构、响应式规则和质检标准。&lt;/p&gt;&#xA;&lt;h3 id=&#34;第四步优化文字内容&#34;&gt;第四步：优化文字内容&#xA;&lt;/h3&gt;&lt;p&gt;使用 &lt;code&gt;Humanizer-zh&lt;/code&gt; 调整页面文案、README 和博客内容，减少机械化表达。&lt;/p&gt;&#xA;&lt;h3 id=&#34;第五步完成最小修改并验证&#34;&gt;第五步：完成最小修改并验证&#xA;&lt;/h3&gt;&lt;p&gt;使用编码原则 Skill 限制修改范围，并执行测试、构建和代码检查。&lt;/p&gt;&#xA;&lt;p&gt;完整流程可以概括为：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;7&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;8&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;9&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;历史知识检索&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;    ↓&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;需求追问与方案审查&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;    ↓&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;UI 设计与代码实现&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;    ↓&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;中文内容优化&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;    ↓&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;测试、验证与交付&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;hr&gt;&#xA;&lt;h2 id=&#34;实际使用时不需要每次启用全部-skill&#34;&gt;实际使用时，不需要每次启用全部 Skill&#xA;&lt;/h2&gt;&lt;p&gt;五个 Skill 不一定每次都要同时使用。&lt;/p&gt;&#xA;&lt;p&gt;可以根据任务类型进行组合：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;  &lt;thead&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;th&gt;任务&lt;/th&gt;&#xA;          &lt;th&gt;推荐 Skill&lt;/th&gt;&#xA;      &lt;/tr&gt;&#xA;  &lt;/thead&gt;&#xA;  &lt;tbody&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;整理项目经验&lt;/td&gt;&#xA;          &lt;td&gt;obsidian-skills&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;开发复杂新功能&lt;/td&gt;&#xA;          &lt;td&gt;obsidian-skills + grill-me + 编码原则&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;制作网站页面&lt;/td&gt;&#xA;          &lt;td&gt;UI Skill + Humanizer-zh + 编码原则&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;编写技术文章&lt;/td&gt;&#xA;          &lt;td&gt;obsidian-skills + Humanizer-zh&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;重构旧项目&lt;/td&gt;&#xA;          &lt;td&gt;grill-me + 编码原则&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;制作产品落地页&lt;/td&gt;&#xA;          &lt;td&gt;UI Skill + Humanizer-zh&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;排查历史问题&lt;/td&gt;&#xA;          &lt;td&gt;obsidian-skills + 编码原则&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;  &lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;Skill 数量并不是越多越好。真正重要的是每个 Skill 都有明确职责，并且不会互相冲突。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;总结&#34;&gt;总结&#xA;&lt;/h2&gt;&lt;p&gt;Codex 的价值不只是生成代码。&lt;/p&gt;&#xA;&lt;p&gt;通过 Skills，可以将知识、规范和工作流程固定下来，让 Codex逐渐具备以下能力：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;读取并整理项目知识&lt;/li&gt;&#xA;&lt;li&gt;在开发前审查需求&lt;/li&gt;&#xA;&lt;li&gt;根据业务选择设计语言&lt;/li&gt;&#xA;&lt;li&gt;优化中文内容表达&lt;/li&gt;&#xA;&lt;li&gt;控制代码修改范围&lt;/li&gt;&#xA;&lt;li&gt;在交付前完成自我验证&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;最终目标不是让 Codex 一次生成更多代码，而是减少沟通成本、降低返工概率，让每次修改都更加稳定和可控。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;github-项目地址&#34;&gt;GitHub 项目地址&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/openai/skills&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;OpenAI Skills：Codex Skills 官方目录&lt;/a&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/kepano/obsidian-skills&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;obsidian-skills&lt;/a&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/op7418/Humanizer-zh&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;Humanizer-zh&lt;/a&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/mattpocock/skills&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;grill-me 所在 Skills 项目&lt;/a&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/nextlevelbuilder/ui-ux-pro-max-skill&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;UI UX Pro Max Skill&lt;/a&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/vipulgupta2048/codex-skills&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;Codex Frontend Design Skill&lt;/a&gt;&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&#xA;    &lt;blockquote&gt;&#xA;        &lt;p&gt;“编码原则”部分属于可自行创建的自定义 Skill，并非本文确认的单一 GitHub 项目。&lt;/p&gt;&#xA;&#xA;    &lt;/blockquote&gt;&#xA;&lt;div class=&#34;footnotes&#34; role=&#34;doc-endnotes&#34;&gt;&#xA;&lt;hr&gt;&#xA;&lt;ol&gt;&#xA;&lt;li id=&#34;fn:1&#34;&gt;&#xA;&lt;p&gt;OpenAI Skills 项目将 Agent Skills 描述为由指令、脚本和资源组成的模块化目录，可帮助 Codex 重复执行特定任务。&amp;#160;&lt;a href=&#34;#fnref:1&#34; class=&#34;footnote-backref&#34; role=&#34;doc-backlink&#34;&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li id=&#34;fn:2&#34;&gt;&#xA;&lt;p&gt;obsidian-skills 项目说明其遵循 Agent Skills 规范，并支持 Codex CLI。&amp;#160;&lt;a href=&#34;#fnref:2&#34; class=&#34;footnote-backref&#34; role=&#34;doc-backlink&#34;&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li id=&#34;fn:3&#34;&gt;&#xA;&lt;p&gt;UI UX Pro Max Skill 提供多种设计风格、配色、字体组合、UX 规则与技术栈支持。&amp;#160;&lt;a href=&#34;#fnref:3&#34; class=&#34;footnote-backref&#34; role=&#34;doc-backlink&#34;&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li id=&#34;fn:4&#34;&gt;&#xA;&lt;p&gt;Humanizer-zh 用于识别和减少中文文本中的 AI 生成痕迹。&amp;#160;&lt;a href=&#34;#fnref:4&#34; class=&#34;footnote-backref&#34; role=&#34;doc-backlink&#34;&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li id=&#34;fn:5&#34;&gt;&#xA;&lt;p&gt;grill-me 用于通过持续追问，对计划、需求或设计方案进行压力测试。&amp;#160;&lt;a href=&#34;#fnref:5&#34; class=&#34;footnote-backref&#34; role=&#34;doc-backlink&#34;&gt;&amp;#x21a9;&amp;#xfe0e;&lt;/a&gt;&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;/div&gt;&#xA;</description>
        </item><item>
            <title>Skills 创建全流程：从需求规划到测试落地，零基础也能完成</title>
            <link>https://www.tood.win/posts/skills-chuang-jian-quan-liu-cheng-cong-xu-qiu-gui/</link>
            <pubDate>Tue, 28 Jul 2026 11:08:00 +0800</pubDate>
            <guid>https://www.tood.win/posts/skills-chuang-jian-quan-liu-cheng-cong-xu-qiu-gui/</guid>
            <description>&lt;p&gt;很多人第一次接触 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/skills/&#34; &gt;Skills&lt;/a&gt; 时，会认为它只是一个写了提示词的 Markdown 文件。&lt;/p&gt;&#xA;&lt;p&gt;实际上，一个真正稳定、可复用的 Skill，更像是一份专门交给 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/ai/&#34; &gt;AI&lt;/a&gt; 执行的标准作业流程。它不仅要告诉 AI“做什么”，还要说明什么时候启用、按照什么步骤执行、需要读取哪些资料，以及最终应该输出什么结果。&lt;/p&gt;&#xA;&lt;p&gt;本文将完整梳理 Skills 创建流程，从前期规划、目录初始化、&lt;code&gt;SKILL.md&lt;/code&gt; 编写，到验证与实际测试。即使没有开发经验，也可以按照步骤逐步完成。&lt;/p&gt;&#xA;&lt;p&gt;&lt;img alt=&#34;Image_2026728_11_11_46&#34; loading=&#34;lazy&#34; sizes=&#34;(max-width: 767px) calc(100vw - 30px), (max-width: 1023px) 700px, (max-width: 1279px) 950px, 1232px&#34; src=&#34;https://www.tood.win/uploads/2026/07/Image_2026728_11_11_46-9bbd7f8a.jpg&#34;&gt;&lt;/p&gt;&#xA;&lt;h2 id=&#34;一什么是-skill&#34;&gt;一、什么是 Skill？&#xA;&lt;/h2&gt;&lt;p&gt;Skill 是一个独立的文件夹，其中包含 AI 完成特定任务所需要的说明、脚本、参考资料和模板资源。&lt;/p&gt;&#xA;&lt;p&gt;它可以把通用 AI 转变成更适合某项工作的专业助手，例如：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;按固定格式撰写产品介绍&lt;/li&gt;&#xA;&lt;li&gt;根据公司规范回复客户邮件&lt;/li&gt;&#xA;&lt;li&gt;自动分析 Excel 或 CSV 数据&lt;/li&gt;&#xA;&lt;li&gt;按统一标准生成网站文章&lt;/li&gt;&#xA;&lt;li&gt;批量处理图片或 PDF 文件&lt;/li&gt;&#xA;&lt;li&gt;调用特定 API 完成固定工作流&lt;/li&gt;&#xA;&lt;li&gt;根据团队规范检查代码&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;一个 Skill 通常围绕一个明确任务设计，而不是试图解决所有问题。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h1 id=&#34;第一阶段前期规划&#34;&gt;第一阶段：前期规划&#xA;&lt;/h1&gt;&lt;p&gt;在创建文件之前，先把 Skill 的目标和使用方式规划清楚。&lt;/p&gt;&#xA;&lt;p&gt;这一步看似没有写代码，却会直接决定 Skill 是否容易触发、执行是否稳定，以及后续是否方便维护。&lt;/p&gt;&#xA;&lt;h2 id=&#34;1-明确-skill-的目标&#34;&gt;1. 明确 Skill 的目标&#xA;&lt;/h2&gt;&lt;p&gt;建议从以下四个方面定义目标。&lt;/p&gt;&#xA;&lt;h3 id=&#34;11-功能描述&#34;&gt;1.1 功能描述&#xA;&lt;/h3&gt;&lt;p&gt;首先说明这个 Skill 具体解决什么问题。&lt;/p&gt;&#xA;&lt;p&gt;不要只写：&lt;/p&gt;&#xA;&#xA;    &lt;blockquote&gt;&#xA;        &lt;p&gt;帮助用户处理内容。&lt;/p&gt;&#xA;&#xA;    &lt;/blockquote&gt;&#xA;&lt;p&gt;这种描述过于宽泛，AI 很难判断应该在什么情况下调用它。&lt;/p&gt;&#xA;&lt;p&gt;更清晰的写法是：&lt;/p&gt;&#xA;&#xA;    &lt;blockquote&gt;&#xA;        &lt;p&gt;根据用户提供的原始资料，生成适合个人博客发布的中文 Markdown 文章，并补充标题、文章结构、&lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/seo/&#34; &gt;SEO&lt;/a&gt; 关键词、标签和项目地址。&lt;/p&gt;&#xA;&#xA;    &lt;/blockquote&gt;&#xA;&lt;p&gt;功能描述越具体，后续越容易设计执行流程。&lt;/p&gt;&#xA;&lt;h3 id=&#34;12-适用场景&#34;&gt;1.2 适用场景&#xA;&lt;/h3&gt;&lt;p&gt;明确用户在什么情况下需要使用这个 Skill。&lt;/p&gt;&#xA;&lt;p&gt;例如：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;用户要求润色个人博客文章&lt;/li&gt;&#xA;&lt;li&gt;用户提供视频文案，希望整理成教程&lt;/li&gt;&#xA;&lt;li&gt;用户希望生成可直接复制的 Markdown 内容&lt;/li&gt;&#xA;&lt;li&gt;用户希望补充 GitHub 项目地址&lt;/li&gt;&#xA;&lt;li&gt;用户要求文章适合 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/google/&#34; &gt;Google&lt;/a&gt; SEO 和 AI 搜索引用&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;适用场景也是 Skill 判断是否应该触发的重要依据。&lt;/p&gt;&#xA;&lt;h3 id=&#34;13-预期输出&#34;&gt;1.3 预期输出&#xA;&lt;/h3&gt;&lt;p&gt;提前规定 Skill 完成任务后应该交付什么。&lt;/p&gt;&#xA;&lt;p&gt;例如：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;7&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;1. 原文问题分析&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;2. 建议补充的信息&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;3. 优化后的文章标题&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;4. 可直接复制的 Markdown 正文&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;5. SEO 描述&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;6. Tags 标签&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;7. 项目地址&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;输出格式越明确，多次执行时的结果越稳定。&lt;/p&gt;&#xA;&lt;h3 id=&#34;14-限制条件&#34;&gt;1.4 限制条件&#xA;&lt;/h3&gt;&lt;p&gt;同时还要说明 Skill 不应该做什么。&lt;/p&gt;&#xA;&lt;p&gt;例如：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;不虚构测试数据&lt;/li&gt;&#xA;&lt;li&gt;不编造 GitHub Stars 数量&lt;/li&gt;&#xA;&lt;li&gt;无法确认的信息需要明确标注&lt;/li&gt;&#xA;&lt;li&gt;不堆砌 SEO 关键词&lt;/li&gt;&#xA;&lt;li&gt;不在文章中保留明显错别字&lt;/li&gt;&#xA;&lt;li&gt;不泄露 API Key、密码或个人隐私&lt;/li&gt;&#xA;&lt;li&gt;未经确认不得执行删除、付款或生产环境修改&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;限制条件可以减少 AI 自由发挥过度造成的问题。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;2-分析实际需求&#34;&gt;2. 分析实际需求&#xA;&lt;/h2&gt;&lt;p&gt;目标明确后，需要从用户、技术、性能和兼容性四个维度继续分析。&lt;/p&gt;&#xA;&lt;h3 id=&#34;21-用户需求&#34;&gt;2.1 用户需求&#xA;&lt;/h3&gt;&lt;p&gt;先判断谁会使用这个 Skill，以及他们会如何提出请求。&lt;/p&gt;&#xA;&lt;p&gt;建议至少准备 3～5 个真实示例。&lt;/p&gt;&#xA;&lt;p&gt;例如，创建一个博客文章优化 Skill 时，用户可能会这样说：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;帮我把这段视频文案整理成博客文章。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;重新润色这篇文章，并补充 GitHub 项目地址。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;生成可以直接复制到 Hugo 网站中的 Markdown 内容。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;让文章更适合 Google SEO 和 AI 搜索引用。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;这些真实表达可以帮助你完善 Skill 的触发描述。&lt;/p&gt;&#xA;&lt;h3 id=&#34;22-技术需求&#34;&gt;2.2 技术需求&#xA;&lt;/h3&gt;&lt;p&gt;检查 Skill 是否需要额外工具或文件。&lt;/p&gt;&#xA;&lt;p&gt;常见资源包括：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;Python 或 Bash 脚本&lt;/li&gt;&#xA;&lt;li&gt;API 接口&lt;/li&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/mcp/&#34; &gt;MCP&lt;/a&gt; 服务&lt;/li&gt;&#xA;&lt;li&gt;浏览器搜索能力&lt;/li&gt;&#xA;&lt;li&gt;GitHub 项目资料&lt;/li&gt;&#xA;&lt;li&gt;公司内部文档&lt;/li&gt;&#xA;&lt;li&gt;Markdown 模板&lt;/li&gt;&#xA;&lt;li&gt;图片、Logo 或字体&lt;/li&gt;&#xA;&lt;li&gt;Excel、PDF、Word 处理工具&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;并不是每个 Skill 都需要脚本。&lt;/p&gt;&#xA;&lt;p&gt;能够通过清晰文字说明完成的任务，优先写在 &lt;code&gt;SKILL.md&lt;/code&gt; 中；只有重复、容易出错或需要固定结果的操作，才更适合使用脚本。&lt;/p&gt;&#xA;&lt;h3 id=&#34;23-性能需求&#34;&gt;2.3 性能需求&#xA;&lt;/h3&gt;&lt;p&gt;提前考虑执行成本和效率，例如：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;是否需要联网搜索&lt;/li&gt;&#xA;&lt;li&gt;是否会读取大型文件&lt;/li&gt;&#xA;&lt;li&gt;是否需要处理大量图片&lt;/li&gt;&#xA;&lt;li&gt;是否会调用付费 API&lt;/li&gt;&#xA;&lt;li&gt;是否需要批量执行&lt;/li&gt;&#xA;&lt;li&gt;是否存在较长的运行时间&lt;/li&gt;&#xA;&lt;li&gt;是否需要限制 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/token/&#34; &gt;Token&lt;/a&gt; 消耗&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;Skill 内容也不宜无限扩张。应只保留 AI 真正需要的规则，把较长的资料放入 &lt;code&gt;references/&lt;/code&gt;，需要时再读取。&lt;/p&gt;&#xA;&lt;h3 id=&#34;24-兼容性需求&#34;&gt;2.4 兼容性需求&#xA;&lt;/h3&gt;&lt;p&gt;确认 Skill 将在哪些平台或环境中运行，例如：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;Codex&lt;/li&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/claude/&#34; &gt;Claude&lt;/a&gt; Code&lt;/li&gt;&#xA;&lt;li&gt;GitHub Copilot&lt;/li&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/cursor/&#34; &gt;Cursor&lt;/a&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/gemini/&#34; &gt;Gemini&lt;/a&gt; CLI&lt;/li&gt;&#xA;&lt;li&gt;Windows&lt;/li&gt;&#xA;&lt;li&gt;macOS&lt;/li&gt;&#xA;&lt;li&gt;Linux&lt;/li&gt;&#xA;&lt;li&gt;Docker&lt;/li&gt;&#xA;&lt;li&gt;团队内部 Agent 平台&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;不同平台对 Skill 的安装路径、元数据和调用方式可能不同，因此不要默认一个 Skill 在所有环境中都能完全通用。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h1 id=&#34;第二阶段正式创建-skill&#34;&gt;第二阶段：正式创建 Skill&#xA;&lt;/h1&gt;&lt;p&gt;规划完成后，就可以开始建立目录和编写内容。&lt;/p&gt;&#xA;&lt;h2 id=&#34;3-skill-命名规范&#34;&gt;3. Skill 命名规范&#xA;&lt;/h2&gt;&lt;p&gt;建议使用：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;小写英文字母&lt;/li&gt;&#xA;&lt;li&gt;数字&lt;/li&gt;&#xA;&lt;li&gt;连字符 &lt;code&gt;-&lt;/code&gt;&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;不要使用：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;空格&lt;/li&gt;&#xA;&lt;li&gt;中文文件夹名&lt;/li&gt;&#xA;&lt;li&gt;下划线&lt;/li&gt;&#xA;&lt;li&gt;大写字母&lt;/li&gt;&#xA;&lt;li&gt;含义不清的缩写&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;正确示例：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;blog-content-optimizer&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;fabric-email-writer&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;github-project-researcher&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;不推荐：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;My Skill&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;blog_skill&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;新建技能&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;文件夹名称应该与 &lt;code&gt;SKILL.md&lt;/code&gt; 中的 &lt;code&gt;name&lt;/code&gt; 保持一致。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;4-使用-skill-creator-初始化&#34;&gt;4. 使用 Skill Creator 初始化&#xA;&lt;/h2&gt;&lt;p&gt;如果当前环境中已经安装官方 &lt;code&gt;skill-creator&lt;/code&gt;，建议优先使用初始化脚本，而不是手动建立所有文件。&lt;/p&gt;&#xA;&lt;p&gt;标准命令格式：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;scripts/init_skill.py &amp;lt;skill-name&amp;gt; --path &amp;lt;output-directory&amp;gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;例如，将 Skill 创建到 Codex 默认 Skills 目录：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;scripts/init_skill.py my-skill &lt;span class=&#34;se&#34;&gt;\&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;  --path &lt;span class=&#34;s2&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span class=&#34;si&#34;&gt;${&lt;/span&gt;&lt;span class=&#34;nv&#34;&gt;CODEX_HOME&lt;/span&gt;&lt;span class=&#34;k&#34;&gt;:-&lt;/span&gt;&lt;span class=&#34;nv&#34;&gt;$HOME&lt;/span&gt;&lt;span class=&#34;p&#34;&gt;/.codex&lt;/span&gt;&lt;span class=&#34;si&#34;&gt;}&lt;/span&gt;&lt;span class=&#34;s2&#34;&gt;/skills&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;同时创建 &lt;code&gt;scripts/&lt;/code&gt; 和 &lt;code&gt;references/&lt;/code&gt;：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;scripts/init_skill.py my-skill &lt;span class=&#34;se&#34;&gt;\&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;  --path &lt;span class=&#34;s2&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span class=&#34;si&#34;&gt;${&lt;/span&gt;&lt;span class=&#34;nv&#34;&gt;CODEX_HOME&lt;/span&gt;&lt;span class=&#34;k&#34;&gt;:-&lt;/span&gt;&lt;span class=&#34;nv&#34;&gt;$HOME&lt;/span&gt;&lt;span class=&#34;p&#34;&gt;/.codex&lt;/span&gt;&lt;span class=&#34;si&#34;&gt;}&lt;/span&gt;&lt;span class=&#34;s2&#34;&gt;/skills&amp;#34;&lt;/span&gt; &lt;span class=&#34;se&#34;&gt;\&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;  --resources scripts,references&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;同时创建脚本、参考资料和静态资源目录：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;scripts/init_skill.py my-skill &lt;span class=&#34;se&#34;&gt;\&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;  --path &lt;span class=&#34;s2&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span class=&#34;si&#34;&gt;${&lt;/span&gt;&lt;span class=&#34;nv&#34;&gt;CODEX_HOME&lt;/span&gt;&lt;span class=&#34;k&#34;&gt;:-&lt;/span&gt;&lt;span class=&#34;nv&#34;&gt;$HOME&lt;/span&gt;&lt;span class=&#34;p&#34;&gt;/.codex&lt;/span&gt;&lt;span class=&#34;si&#34;&gt;}&lt;/span&gt;&lt;span class=&#34;s2&#34;&gt;/skills&amp;#34;&lt;/span&gt; &lt;span class=&#34;se&#34;&gt;\&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;  --resources scripts,references,assets&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;初始化脚本可以自动生成基础模板，减少目录名称、YAML 格式和必要文件写错的概率。&lt;/p&gt;&#xA;&#xA;    &lt;blockquote&gt;&#xA;        &lt;p&gt;不同版本的 Skill Creator 所在路径可能不同。实际使用时，应以本机安装目录中的 &lt;code&gt;skill-creator&lt;/code&gt; 文件为准。&lt;/p&gt;&#xA;&#xA;    &lt;/blockquote&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;5-手动创建-skill-目录&#34;&gt;5. 手动创建 Skill 目录&#xA;&lt;/h2&gt;&lt;p&gt;没有初始化脚本时，也可以手动创建。&lt;/p&gt;&#xA;&lt;h3 id=&#34;windows-powershell&#34;&gt;Windows PowerShell&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;7&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;8&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;9&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-powershell&#34; data-lang=&#34;powershell&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;n&#34;&gt;mkdir&lt;/span&gt; &lt;span class=&#34;nb&#34;&gt;my-skill&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nb&#34;&gt;cd my-skill&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nb&#34;&gt;New-Item&lt;/span&gt; &lt;span class=&#34;n&#34;&gt;SKILL&lt;/span&gt;&lt;span class=&#34;p&#34;&gt;.&lt;/span&gt;&lt;span class=&#34;nb&#34;&gt;md &lt;/span&gt;&lt;span class=&#34;n&#34;&gt;-ItemType&lt;/span&gt; &lt;span class=&#34;n&#34;&gt;File&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;n&#34;&gt;mkdir&lt;/span&gt; &lt;span class=&#34;n&#34;&gt;scripts&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;n&#34;&gt;mkdir&lt;/span&gt; &lt;span class=&#34;n&#34;&gt;references&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;n&#34;&gt;mkdir&lt;/span&gt; &lt;span class=&#34;n&#34;&gt;assets&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;n&#34;&gt;tree&lt;/span&gt; &lt;span class=&#34;p&#34;&gt;/&lt;/span&gt;&lt;span class=&#34;n&#34;&gt;F&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h3 id=&#34;macos-或-linux&#34;&gt;macOS 或 Linux&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;7&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;mkdir my-skill&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nb&#34;&gt;cd&lt;/span&gt; my-skill&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;touch SKILL.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;mkdir scripts references assets&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;tree -a&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;如果系统没有安装 &lt;code&gt;tree&lt;/code&gt;，可以使用：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;find . -maxdepth &lt;span class=&#34;m&#34;&gt;3&lt;/span&gt; -print&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;或者：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;ls -la&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;需要注意，&lt;code&gt;scripts/&lt;/code&gt;、&lt;code&gt;references/&lt;/code&gt; 和 &lt;code&gt;assets/&lt;/code&gt; 都是可选目录。没有实际用途时，不需要为了结构完整而创建空文件夹。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;6-标准目录结构&#34;&gt;6. 标准目录结构&#xA;&lt;/h2&gt;&lt;p&gt;一个较完整的 Codex Skill 可以采用以下结构：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;7&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;my-skill/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── SKILL.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── agents/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;│   └── openai.yaml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── scripts/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── references/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;└── assets/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;各目录作用如下。&lt;/p&gt;&#xA;&lt;h3 id=&#34;skillmd&#34;&gt;&lt;code&gt;SKILL.md&lt;/code&gt;&#xA;&lt;/h3&gt;&lt;p&gt;这是整个 Skill 的核心文件，必须存在。&lt;/p&gt;&#xA;&lt;p&gt;它负责说明：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;Skill 名称&lt;/li&gt;&#xA;&lt;li&gt;Skill 的用途&lt;/li&gt;&#xA;&lt;li&gt;什么时候应该触发&lt;/li&gt;&#xA;&lt;li&gt;应该按照什么流程执行&lt;/li&gt;&#xA;&lt;li&gt;应该读取哪些资源&lt;/li&gt;&#xA;&lt;li&gt;最终输出什么结果&lt;/li&gt;&#xA;&lt;li&gt;有哪些限制条件&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;文件名必须写成：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;SKILL.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;不建议写成：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;skill.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;部分系统区分大小写，错误命名可能导致 Skill 无法被识别。&lt;/p&gt;&#xA;&lt;h3 id=&#34;agentsopenaiyaml&#34;&gt;&lt;code&gt;agents/openai.yaml&lt;/code&gt;&#xA;&lt;/h3&gt;&lt;p&gt;这是 Codex Skill 推荐使用的界面元数据文件，可用于展示：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;Skill 显示名称&lt;/li&gt;&#xA;&lt;li&gt;简短说明&lt;/li&gt;&#xA;&lt;li&gt;默认提示语&lt;/li&gt;&#xA;&lt;li&gt;图标或界面相关信息&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;它主要服务于 Skill 列表和交互界面，不应代替 &lt;code&gt;SKILL.md&lt;/code&gt; 中的核心执行规则。&lt;/p&gt;&#xA;&lt;h3 id=&#34;scripts&#34;&gt;&lt;code&gt;scripts/&lt;/code&gt;&#xA;&lt;/h3&gt;&lt;p&gt;用于保存可以重复执行的代码，例如：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;4&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;scripts/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── clean_markdown.py&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── validate_output.py&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;└── export_result.py&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;适合放入脚本的任务通常具备以下特点：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;操作步骤固定&lt;/li&gt;&#xA;&lt;li&gt;需要重复执行&lt;/li&gt;&#xA;&lt;li&gt;手动生成容易出错&lt;/li&gt;&#xA;&lt;li&gt;结果必须保持一致&lt;/li&gt;&#xA;&lt;li&gt;需要调用本地程序或处理文件&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;新增脚本后，应实际运行测试，不能只确认代码看起来正确。&lt;/p&gt;&#xA;&lt;h3 id=&#34;references&#34;&gt;&lt;code&gt;references/&lt;/code&gt;&#xA;&lt;/h3&gt;&lt;p&gt;用于保存参考资料，例如：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;5&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;references/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── writing-rules.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── seo-checklist.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── api-documentation.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;└── company-style-guide.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;较长的背景资料不建议全部塞进 &lt;code&gt;SKILL.md&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;p&gt;可以在 &lt;code&gt;SKILL.md&lt;/code&gt; 中说明什么时候读取某份参考资料，让 AI 按需加载，从而减少上下文占用。&lt;/p&gt;&#xA;&lt;h3 id=&#34;assets&#34;&gt;&lt;code&gt;assets/&lt;/code&gt;&#xA;&lt;/h3&gt;&lt;p&gt;用于保存最终任务可能使用的静态资源，例如：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;5&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;assets/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── logo.png&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── article-template.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── report-template.docx&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;└── website-template/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;它适合存放：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;图片&lt;/li&gt;&#xA;&lt;li&gt;图标&lt;/li&gt;&#xA;&lt;li&gt;Logo&lt;/li&gt;&#xA;&lt;li&gt;文档模板&lt;/li&gt;&#xA;&lt;li&gt;网页模板&lt;/li&gt;&#xA;&lt;li&gt;示例文件&lt;/li&gt;&#xA;&lt;li&gt;需要复制到输出结果中的资源&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;license-或-licensetxt&#34;&gt;&lt;code&gt;LICENSE&lt;/code&gt; 或 &lt;code&gt;LICENSE.txt&lt;/code&gt;&#xA;&lt;/h3&gt;&lt;p&gt;如果 Skill 准备公开发布或共享给团队，应明确授权方式。&lt;/p&gt;&#xA;&lt;p&gt;常见许可证包括：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;MIT License&lt;/li&gt;&#xA;&lt;li&gt;Apache License 2.0&lt;/li&gt;&#xA;&lt;li&gt;GNU GPL&lt;/li&gt;&#xA;&lt;li&gt;项目自定义许可证&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;对于仅在个人电脑内部使用的 Skill，许可证通常不是运行所必需的；但公开到 GitHub 前，建议补充清晰的授权文件。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h1 id=&#34;第三阶段编写-skillmd&#34;&gt;第三阶段：编写 SKILL.md&#xA;&lt;/h1&gt;&lt;h2 id=&#34;7-yaml-frontmatter&#34;&gt;7. YAML Frontmatter&#xA;&lt;/h2&gt;&lt;p&gt;&lt;code&gt;SKILL.md&lt;/code&gt; 顶部需要包含 YAML 元数据。&lt;/p&gt;&#xA;&lt;p&gt;基础格式：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;4&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-markdown&#34; data-lang=&#34;markdown&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;---&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;name: my-skill&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;description: Explain what this skill does and exactly when it should be used.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;---&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;其中最重要的是 &lt;code&gt;description&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;p&gt;它不仅是介绍文字，也是 AI 判断是否调用这个 Skill 的主要依据。&lt;/p&gt;&#xA;&lt;p&gt;不推荐：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nt&#34;&gt;description&lt;/span&gt;&lt;span class=&#34;p&#34;&gt;:&lt;/span&gt;&lt;span class=&#34;w&#34;&gt; &lt;/span&gt;&lt;span class=&#34;l&#34;&gt;一个非常好用的内容处理工具。&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;推荐：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;nt&#34;&gt;description&lt;/span&gt;&lt;span class=&#34;p&#34;&gt;:&lt;/span&gt;&lt;span class=&#34;w&#34;&gt; &lt;/span&gt;&lt;span class=&#34;l&#34;&gt;Optimize Chinese personal-blog articles into structured Markdown content. Use when users ask to rewrite video transcripts, improve Google SEO readability, add verifiable GitHub project information, generate tags, or prepare copy-ready Markdown for a website.&lt;/span&gt;&lt;span class=&#34;w&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;一段有效的描述需要同时回答两个问题：&lt;/p&gt;&#xA;&lt;ol&gt;&#xA;&lt;li&gt;这个 Skill 能做什么？&lt;/li&gt;&#xA;&lt;li&gt;用户提出什么请求时应该使用它？&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;8-编写执行流程&#34;&gt;8. 编写执行流程&#xA;&lt;/h2&gt;&lt;p&gt;&lt;code&gt;SKILL.md&lt;/code&gt; 正文应该以明确、可执行的规则为主。&lt;/p&gt;&#xA;&lt;p&gt;下面是一个简单示例：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt; 1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 7&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 8&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 9&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;10&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;11&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;12&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;13&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;14&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;15&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;16&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;17&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;18&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;19&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;20&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;21&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;22&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;23&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;24&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;25&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;26&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;27&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;28&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;29&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;30&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;31&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;32&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;33&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;34&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;35&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;36&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;37&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-markdown&#34; data-lang=&#34;markdown&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;---&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;name: blog-content-optimizer&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;description: Optimize Chinese blog content into clear, credible and copy-ready Markdown. Use when the user provides rough notes, transcripts or existing articles and asks for rewriting, SEO improvement, GitHub project verification, tags or website publishing content.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;---&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gh&#34;&gt;# Blog Content Optimizer&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## Workflow&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;1.&lt;/span&gt; Read the complete source material.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;2.&lt;/span&gt; Correct spelling, command and terminology errors silently.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;3.&lt;/span&gt; Identify vague, repetitive or overly promotional statements.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;4.&lt;/span&gt; Determine what factual information is missing.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;5.&lt;/span&gt; Verify time-sensitive claims and GitHub project information.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;6.&lt;/span&gt; Rewrite the article in clear Chinese Markdown.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;7.&lt;/span&gt; Preserve relevant SEO keywords naturally.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;8.&lt;/span&gt; Add the verified project address at the end.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;9.&lt;/span&gt; Generate comma-separated tags.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## Output&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;Return the following sections:&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;1.&lt;/span&gt; 原文存在的问题&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;2.&lt;/span&gt; 建议补充的信息&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;3.&lt;/span&gt; 中文优化版&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;4.&lt;/span&gt; Tags&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;5.&lt;/span&gt; 项目地址&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;gu&#34;&gt;## Rules&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; Do not fabricate facts, statistics, Stars or test results.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; Do not stuff keywords.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; Do not mention spelling corrections in the final article.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; Mark information that cannot be verified.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; Keep headings descriptive and easy to quote.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&lt;span class=&#34;k&#34;&gt;-&lt;/span&gt; Prefer concrete steps and examples over marketing language.&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;这类写法比长篇介绍更有效，因为每一条都可以直接指导 AI 执行。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h1 id=&#34;第四阶段验证与测试&#34;&gt;第四阶段：验证与测试&#xA;&lt;/h1&gt;&lt;h2 id=&#34;9-运行基础校验&#34;&gt;9. 运行基础校验&#xA;&lt;/h2&gt;&lt;p&gt;完成 Skill 后，可以使用 Skill Creator 提供的验证脚本检查格式。&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;scripts/quick_validate.py &amp;lt;path/to/skill-folder&amp;gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;例如：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;scripts/quick_validate.py ~/.codex/skills/my-skill&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;验证工具通常可以发现：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;code&gt;SKILL.md&lt;/code&gt; 缺失&lt;/li&gt;&#xA;&lt;li&gt;YAML 格式错误&lt;/li&gt;&#xA;&lt;li&gt;缺少 &lt;code&gt;name&lt;/code&gt;&lt;/li&gt;&#xA;&lt;li&gt;缺少 &lt;code&gt;description&lt;/code&gt;&lt;/li&gt;&#xA;&lt;li&gt;文件夹命名不符合规范&lt;/li&gt;&#xA;&lt;li&gt;Skill 名称与目录不一致&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;出现错误后，根据提示修改，再重新运行验证命令。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;10-使用真实任务测试&#34;&gt;10. 使用真实任务测试&#xA;&lt;/h2&gt;&lt;p&gt;通过格式验证，并不代表 Skill 已经真正可用。&lt;/p&gt;&#xA;&lt;p&gt;至少准备 3～5 个测试请求，例如：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;把下面的视频文案整理成可以发布的 Markdown 教程。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;检查这篇文章中的 GitHub 项目是否真实，并补充项目地址。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;让文章更适合 Google SEO，但不要堆砌关键词。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;只修改错别字，不改变原文语气。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;测试时重点观察：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;Skill 是否在正确场景触发&lt;/li&gt;&#xA;&lt;li&gt;不相关请求是否错误触发&lt;/li&gt;&#xA;&lt;li&gt;输出结构是否稳定&lt;/li&gt;&#xA;&lt;li&gt;是否遗漏关键步骤&lt;/li&gt;&#xA;&lt;li&gt;是否读取了正确的参考资料&lt;/li&gt;&#xA;&lt;li&gt;是否出现虚构内容&lt;/li&gt;&#xA;&lt;li&gt;脚本是否能够正常运行&lt;/li&gt;&#xA;&lt;li&gt;多次执行的结果是否基本一致&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;11-根据测试结果持续优化&#34;&gt;11. 根据测试结果持续优化&#xA;&lt;/h2&gt;&lt;p&gt;Skill 通常不会一次完成。&lt;/p&gt;&#xA;&lt;p&gt;更合理的优化循环是：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt; 1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 7&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 8&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 9&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;10&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;11&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;实际使用&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;↓&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;发现遗漏或错误&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;↓&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;定位问题来源&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;↓&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;修改 SKILL.md、脚本或参考资料&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;↓&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;重新验证&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;↓&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;再次使用真实任务测试&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;例如：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;经常没有补充项目地址&#xA;→ 在工作流程和输出格式中同时增加 GitHub 检查要求。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;经常错误触发&#xA;→ 缩小 &lt;code&gt;description&lt;/code&gt; 中的使用范围。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;经常无法识别用户表达&#xA;→ 在 &lt;code&gt;description&lt;/code&gt; 中增加常见触发场景。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;输出格式不稳定&#xA;→ 提供固定模板或示例。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;重复任务消耗较多 Token&#xA;→ 把固定操作改成脚本。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;Skill 的价值并不在于文件数量，而在于它能否让同类任务以更稳定、更可预测的方式重复完成。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h1 id=&#34;哪些情况适合使用-skill-creator&#34;&gt;哪些情况适合使用 Skill Creator？&#xA;&lt;/h1&gt;&lt;h2 id=&#34;1-创建新的-skill&#34;&gt;1. 创建新的 Skill&#xA;&lt;/h2&gt;&lt;p&gt;当你只有一个需求想法，还没有确定目录、执行步骤和输出结构时，可以让 Skill Creator 帮助完成：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;需求梳理&lt;/li&gt;&#xA;&lt;li&gt;使用场景分析&lt;/li&gt;&#xA;&lt;li&gt;目录初始化&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;SKILL.md&lt;/code&gt; 草稿&lt;/li&gt;&#xA;&lt;li&gt;资源规划&lt;/li&gt;&#xA;&lt;li&gt;验证与测试&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;2-优化已有-skill&#34;&gt;2. 优化已有 Skill&#xA;&lt;/h2&gt;&lt;p&gt;如果已有 Skill 经常漏步骤、错误触发或输出不稳定，可以使用 Skill Creator：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;优化 &lt;code&gt;description&lt;/code&gt;&lt;/li&gt;&#xA;&lt;li&gt;精简冗余内容&lt;/li&gt;&#xA;&lt;li&gt;补充测试案例&lt;/li&gt;&#xA;&lt;li&gt;重新规划脚本和参考资料&lt;/li&gt;&#xA;&lt;li&gt;比较修改前后的执行结果&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;3-团队协作&#34;&gt;3. 团队协作&#xA;&lt;/h2&gt;&lt;p&gt;多人共同维护 Skills 时，Skill Creator 可以帮助团队统一：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;目录结构&lt;/li&gt;&#xA;&lt;li&gt;文件命名&lt;/li&gt;&#xA;&lt;li&gt;输出格式&lt;/li&gt;&#xA;&lt;li&gt;开发流程&lt;/li&gt;&#xA;&lt;li&gt;测试标准&lt;/li&gt;&#xA;&lt;li&gt;版本维护方式&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;4-固定且重复的工作流&#34;&gt;4. 固定且重复的工作流&#xA;&lt;/h2&gt;&lt;p&gt;例如只需要几个固定命令或固定步骤的任务，也适合封装成 Skill：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;项目初始化&lt;/li&gt;&#xA;&lt;li&gt;文件格式转换&lt;/li&gt;&#xA;&lt;li&gt;批量重命名&lt;/li&gt;&#xA;&lt;li&gt;发布前检查&lt;/li&gt;&#xA;&lt;li&gt;固定格式报告生成&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;不过，任务越简单，Skill 内容越应该保持精简，不需要为了显得完整而增加大量无用说明。&lt;/p&gt;&#xA;&lt;h2 id=&#34;5-高度定制的业务任务&#34;&gt;5. 高度定制的业务任务&#xA;&lt;/h2&gt;&lt;p&gt;当任务依赖公司内部规范、专业资料、固定模板或特殊流程时，Skill 可以将这些知识组织成可复用资源。&lt;/p&gt;&#xA;&lt;p&gt;例如：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;面料报价邮件规范&lt;/li&gt;&#xA;&lt;li&gt;公司品牌文案规则&lt;/li&gt;&#xA;&lt;li&gt;内部数据库查询方式&lt;/li&gt;&#xA;&lt;li&gt;特定 API 调用流程&lt;/li&gt;&#xA;&lt;li&gt;固定交付文件格式&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;hr&gt;&#xA;&lt;h1 id=&#34;创建-skill-时的常见错误&#34;&gt;创建 Skill 时的常见错误&#xA;&lt;/h1&gt;&lt;h2 id=&#34;错误一目标范围过大&#34;&gt;错误一：目标范围过大&#xA;&lt;/h2&gt;&lt;p&gt;例如：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;帮助用户完成所有办公任务。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;这种 Skill 几乎无法稳定触发，也很难测试。&lt;/p&gt;&#xA;&lt;p&gt;应该拆分成：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;customer-email-writer&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;invoice-data-checker&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;weekly-report-generator&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h2 id=&#34;错误二只写功能不写触发场景&#34;&gt;错误二：只写功能，不写触发场景&#xA;&lt;/h2&gt;&lt;p&gt;如果 &lt;code&gt;description&lt;/code&gt; 没有说明什么时候使用，AI 可能无法正确调用。&lt;/p&gt;&#xA;&lt;h2 id=&#34;错误三把所有资料都写进-skillmd&#34;&gt;错误三：把所有资料都写进 SKILL.md&#xA;&lt;/h2&gt;&lt;p&gt;过长的文件会占用更多上下文。&lt;/p&gt;&#xA;&lt;p&gt;应该将详细资料拆分到 &lt;code&gt;references/&lt;/code&gt;，需要时再读取。&lt;/p&gt;&#xA;&lt;h2 id=&#34;错误四创建大量无用目录&#34;&gt;错误四：创建大量无用目录&#xA;&lt;/h2&gt;&lt;p&gt;没有脚本就不需要建立空的 &lt;code&gt;scripts/&lt;/code&gt;；没有静态资源也不需要建立 &lt;code&gt;assets/&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;h2 id=&#34;错误五脚本没有实际运行&#34;&gt;错误五：脚本没有实际运行&#xA;&lt;/h2&gt;&lt;p&gt;AI 生成的脚本即使语法看起来正确，也可能存在依赖、路径或参数问题，必须实际执行测试。&lt;/p&gt;&#xA;&lt;h2 id=&#34;错误六只验证格式不测试效果&#34;&gt;错误六：只验证格式，不测试效果&#xA;&lt;/h2&gt;&lt;p&gt;格式正确只能证明 Skill 可以被读取，不能证明它能完成真实任务。&lt;/p&gt;&#xA;&lt;h2 id=&#34;错误七在文件中写入敏感信息&#34;&gt;错误七：在文件中写入敏感信息&#xA;&lt;/h2&gt;&lt;p&gt;不要把以下内容直接写入 Skill：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;API Key&lt;/li&gt;&#xA;&lt;li&gt;登录密码&lt;/li&gt;&#xA;&lt;li&gt;Cookie&lt;/li&gt;&#xA;&lt;li&gt;私钥&lt;/li&gt;&#xA;&lt;li&gt;客户隐私数据&lt;/li&gt;&#xA;&lt;li&gt;生产环境凭据&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;敏感信息应通过安全的环境变量或密钥管理工具提供。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h1 id=&#34;总结&#34;&gt;总结&#xA;&lt;/h1&gt;&lt;p&gt;一个标准的 Skills 创建流程，可以归纳为六个步骤：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt; 1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 7&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 8&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 9&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;10&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;11&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;明确目标&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;↓&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;收集真实使用案例&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;↓&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;规划 scripts、references 和 assets&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;↓&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;初始化并编写 SKILL.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;↓&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;运行格式验证和真实任务测试&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;↓&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;根据实际结果持续迭代&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;对于零基础用户来说，最重要的不是一次写出复杂的 Skill，而是先选择一个明确、重复出现的小任务。&lt;/p&gt;&#xA;&lt;p&gt;只要目标清晰、触发场景明确、输出格式固定，并通过真实任务不断测试优化，就可以逐步建立一套属于自己的 AI 工作流程。&lt;/p&gt;&#xA;&lt;hr&gt;&#xA;&lt;h2 id=&#34;相关项目&#34;&gt;相关项目&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/openai/skills&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;OpenAI Skills&lt;/a&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/openai/codex/blob/main/codex-rs/skills/src/assets/samples/skill-creator/SKILL.md&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;OpenAI Codex Skill Creator 示例&lt;/a&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/anthropics/skills&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;Anthropic Skills&lt;/a&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/anthropics/skills/tree/main/skills/skill-creator&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;Anthropic Skill Creator&lt;/a&gt;&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&#xA;    &lt;blockquote&gt;&#xA;        &lt;p&gt;注意：OpenAI 原 &lt;code&gt;openai/skills&lt;/code&gt; 仓库目前已提示弃用，并引导开发者使用新的 OpenAI Plugins 体系。旧仓库仍可用于学习 Skill 的目录结构和设计思路，但正式使用前应查看最新官方文档。&lt;/p&gt;&#xA;&#xA;    &lt;/blockquote&gt;&#xA;</description>
        </item><item>
            <title>Book to Skill：把一本书变成 AI 可以反复调用的知识工具</title>
            <link>https://www.tood.win/posts/book-to-skill-ba-yi-ben-shu-bian-cheng-ai/</link>
            <pubDate>Mon, 27 Jul 2026 19:55:00 +0800</pubDate>
            <guid>https://www.tood.win/posts/book-to-skill-ba-yi-ben-shu-bian-cheng-ai/</guid>
            <description>&lt;p&gt;很多人用 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/ai/&#34; &gt;AI&lt;/a&gt; 阅读一本书时，通常只会做两件事：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;总结全书内容&lt;/li&gt;&#xA;&lt;li&gt;提炼重点和金句&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;这种方式可以帮助我们快速了解一本书，却很难真正把书里的方法应用到工作中。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;Book to &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/skill/&#34; &gt;Skill&lt;/a&gt;&lt;/strong&gt; 提供了另一种思路：把 PDF、EPUB、DOCX、Markdown 等文档转换成结构化的 Agent Skill，让 AI 不只是“读过这本书”，而是能够在后续任务中调用书里的框架、原则和方法，帮助你分析问题、检查方案或生成内容。&lt;/p&gt;&#xA;&lt;p&gt;简单来说，它不是把一本书压缩成一篇摘要，而是把一本书整理成一套可以反复使用的 AI 知识工具。&lt;/p&gt;&#xA;&lt;p&gt;&lt;img alt=&#34;codex-5-tools-carousel-4x3&#34; loading=&#34;lazy&#34; sizes=&#34;(max-width: 767px) calc(100vw - 30px), (max-width: 1023px) 700px, (max-width: 1279px) 950px, 1232px&#34; src=&#34;https://www.tood.win/uploads/2026/07/codex-5-tools-carousel-4x3-980be985.jpg&#34;&gt;&lt;/p&gt;&#xA;&lt;h2 id=&#34;book-to-skill-是什么&#34;&gt;Book to Skill 是什么？&#xA;&lt;/h2&gt;&lt;p&gt;Book to Skill 是一个开源 Agent Skill，主要用于把书籍、技术文档或一组资料转换成结构化 Skill。&lt;/p&gt;&#xA;&lt;p&gt;它会从原始文档中提取：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;核心框架和思维模型&lt;/li&gt;&#xA;&lt;li&gt;可以直接执行的方法&lt;/li&gt;&#xA;&lt;li&gt;决策规则&lt;/li&gt;&#xA;&lt;li&gt;常见错误和反模式&lt;/li&gt;&#xA;&lt;li&gt;重要概念与术语&lt;/li&gt;&#xA;&lt;li&gt;各章节的关键知识&lt;/li&gt;&#xA;&lt;li&gt;快速查询用的速查表&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;生成完成后，AI 可以根据当前任务按需读取对应章节，而不是每次都把整本书重新放进上下文。&lt;/p&gt;&#xA;&lt;p&gt;这意味着，你以后不必反复翻阅几十页甚至几百页的 PDF，也不需要每次重新向 AI 解释这本书讲了什么。&lt;/p&gt;&#xA;&lt;h2 id=&#34;它和普通的-ai-读书总结有什么区别&#34;&gt;它和普通的 AI 读书总结有什么区别？&#xA;&lt;/h2&gt;&lt;p&gt;普通的 AI 总结通常只能回答：&lt;/p&gt;&#xA;&#xA;    &lt;blockquote&gt;&#xA;        &lt;p&gt;这本书主要讲了什么？&lt;/p&gt;&#xA;&#xA;    &lt;/blockquote&gt;&#xA;&lt;p&gt;Book to Skill 更关注的是：&lt;/p&gt;&#xA;&#xA;    &lt;blockquote&gt;&#xA;        &lt;p&gt;这本书里的方法，应该在什么情况下使用？&lt;/p&gt;&#xA;&#xA;    &lt;/blockquote&gt;&#xA;&lt;p&gt;例如，一本内容创作类书籍被转换成 Skill 后，你可以让 AI：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;根据书中的方法策划短视频选题&lt;/li&gt;&#xA;&lt;li&gt;设计视频标题和封面文案&lt;/li&gt;&#xA;&lt;li&gt;检查口播脚本的开头是否足够吸引人&lt;/li&gt;&#xA;&lt;li&gt;分析内容节奏和信息密度&lt;/li&gt;&#xA;&lt;li&gt;判断脚本是否存在留存问题&lt;/li&gt;&#xA;&lt;li&gt;按照书中的标准重写脚本&lt;/li&gt;&#xA;&lt;li&gt;查询某个概念出自哪个章节&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;它输出的不是一份看完就放在一边的读书笔记，而是一套能够参与实际工作的知识系统。&lt;/p&gt;&#xA;&lt;h2 id=&#34;book-to-skill-会生成哪些文件&#34;&gt;Book to Skill 会生成哪些文件？&#xA;&lt;/h2&gt;&lt;p&gt;将一本书转换完成后，通常会得到类似下面的文件结构：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt; 1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 7&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 8&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 9&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;10&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;your-book-skill/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── SKILL.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── glossary.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── patterns.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;├── cheatsheet.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;└── chapters/&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;    ├── ch01-introduction.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;    ├── ch02-framework.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;    ├── ch03-methods.md&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;    └── ...&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;这些文件分别承担不同作用：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;  &lt;thead&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;th&gt;文件&lt;/th&gt;&#xA;          &lt;th&gt;主要用途&lt;/th&gt;&#xA;      &lt;/tr&gt;&#xA;  &lt;/thead&gt;&#xA;  &lt;tbody&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;&lt;code&gt;SKILL.md&lt;/code&gt;&lt;/td&gt;&#xA;          &lt;td&gt;保存核心思维模型、使用说明和章节索引&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;&lt;code&gt;chapters/&lt;/code&gt;&lt;/td&gt;&#xA;          &lt;td&gt;按章节保存详细知识，需要时再读取&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;&lt;code&gt;glossary.md&lt;/code&gt;&lt;/td&gt;&#xA;          &lt;td&gt;整理书中的重要术语和定义&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;&lt;code&gt;patterns.md&lt;/code&gt;&lt;/td&gt;&#xA;          &lt;td&gt;汇总技巧、方法、流程和常见模式&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;      &lt;tr&gt;&#xA;          &lt;td&gt;&lt;code&gt;cheatsheet.md&lt;/code&gt;&lt;/td&gt;&#xA;          &lt;td&gt;保存决策规则和快速参考信息&lt;/td&gt;&#xA;      &lt;/tr&gt;&#xA;  &lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;这种结构比单独生成一篇长摘要更实用。&lt;/p&gt;&#xA;&lt;p&gt;AI 在处理具体问题时，只需要加载相关章节，不必一次把整本书全部塞进上下文，也能减少无关内容对回答的干扰。&lt;/p&gt;&#xA;&lt;h2 id=&#34;支持哪些文档格式&#34;&gt;支持哪些文档格式？&#xA;&lt;/h2&gt;&lt;p&gt;Book to Skill 当前支持多种常见文档格式，包括：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;PDF&lt;/li&gt;&#xA;&lt;li&gt;EPUB&lt;/li&gt;&#xA;&lt;li&gt;DOCX&lt;/li&gt;&#xA;&lt;li&gt;TXT&lt;/li&gt;&#xA;&lt;li&gt;Markdown&lt;/li&gt;&#xA;&lt;li&gt;HTML&lt;/li&gt;&#xA;&lt;li&gt;RTF&lt;/li&gt;&#xA;&lt;li&gt;reStructuredText&lt;/li&gt;&#xA;&lt;li&gt;AsciiDoc&lt;/li&gt;&#xA;&lt;li&gt;MOBI&lt;/li&gt;&#xA;&lt;li&gt;AZW / AZW3&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;除了单本书，它还可以处理整个文件夹、多个文档或符合特定规则的一组文件。&lt;/p&gt;&#xA;&lt;p&gt;因此，它不仅适合处理电子书，也可以用来整理：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;企业内部操作手册&lt;/li&gt;&#xA;&lt;li&gt;品牌规范&lt;/li&gt;&#xA;&lt;li&gt;产品文档&lt;/li&gt;&#xA;&lt;li&gt;技术资料&lt;/li&gt;&#xA;&lt;li&gt;API 说明&lt;/li&gt;&#xA;&lt;li&gt;行业研究报告&lt;/li&gt;&#xA;&lt;li&gt;论文与个人笔记&lt;/li&gt;&#xA;&lt;li&gt;培训教材&lt;/li&gt;&#xA;&lt;li&gt;项目知识库&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;只要这些资料是你经常需要查询和使用的，就可以考虑将它们整理成 Skill。&lt;/p&gt;&#xA;&lt;h2 id=&#34;如何安装-book-to-skill&#34;&gt;如何安装 Book to Skill？&#xA;&lt;/h2&gt;&lt;h3 id=&#34;安装到-claude-code&#34;&gt;安装到 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/claude-code/&#34; &gt;Claude Code&lt;/a&gt;&#xA;&lt;/h3&gt;&lt;p&gt;在终端中执行：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;git clone https://github.com/virgiliojr94/book-to-skill.git ~/.claude/skills/book-to-skill&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;安装完成后，重新启动 Claude Code，或让它重新加载 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/skills/&#34; &gt;Skills&lt;/a&gt;。&lt;/p&gt;&#xA;&lt;h3 id=&#34;安装到-github-copilot-cli&#34;&gt;安装到 GitHub Copilot CLI&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;git clone https://github.com/virgiliojr94/book-to-skill.git ~/.copilot/skills/book-to-skill&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;然后在 Copilot CLI 会话中执行：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;/skills reload&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;/skills info book-to-skill&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h3 id=&#34;安装到通用-agent-skills-目录&#34;&gt;安装到通用 Agent Skills 目录&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;git clone https://github.com/virgiliojr94/book-to-skill.git ~/.agents/skills/book-to-skill&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;这个目录可用于部分兼容开放 Agent Skills 规范的工具。&lt;/p&gt;&#xA;&lt;p&gt;需要注意的是，不同 AI 编程工具对 Skills 的目录、调用命令和兼容程度可能不同。官方仓库当前明确说明支持 Claude Code、GitHub Copilot CLI 和 Amp。其他工具能否直接使用，应以对应工具的 Skills 文档为准。&lt;/p&gt;&#xA;&lt;h2 id=&#34;如何把一本书转换成-skill&#34;&gt;如何把一本书转换成 Skill？&#xA;&lt;/h2&gt;&lt;p&gt;假设电脑中有一本书：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;~/books/content-guide.pdf&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;可以执行：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;/book-to-skill ~/books/content-guide.pdf&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;也可以在命令后指定生成的 Skill 名称：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;/book-to-skill ~/books/content-guide.pdf content-creator-guide&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;如果需要把多份资料合并成一个 Skill，可以执行：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;/book-to-skill ~/books/book.pdf ~/notes/my-notes.md content-knowledge&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;处理整个文件夹：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;/book-to-skill ~/documents/project-docs/ project-knowledge&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;处理某个目录中的全部 EPUB 文件：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;/book-to-skill &amp;#34;~/books/*.epub&amp;#34; my-book-library&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;Book to Skill 在正式生成前，还可以先分析文档结构、估算 &lt;a class=&#34;link&#34; href=&#34;https://www.tood.win/tags/token/&#34; &gt;Token&lt;/a&gt; 消耗，并展示预计生成的文件。&lt;/p&gt;&#xA;&lt;p&gt;对于篇幅较长的书，建议先选择分析模式，确认提取出来的框架和章节是否准确，再继续生成完整 Skill。&lt;/p&gt;&#xA;&lt;h2 id=&#34;一个实际应用案例&#34;&gt;一个实际应用案例&#xA;&lt;/h2&gt;&lt;p&gt;假设你有一本关于短视频内容创作的电子书。&lt;/p&gt;&#xA;&lt;p&gt;转换成 Skill 后，可以让 AI 完成以下任务。&lt;/p&gt;&#xA;&lt;h3 id=&#34;1-快速了解全书&#34;&gt;1. 快速了解全书&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;请基于这个 Skill，整理全书的核心框架、关键原则和主要方法。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h3 id=&#34;2-生成短视频方案&#34;&gt;2. 生成短视频方案&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;请使用书中的内容创作框架，策划一条介绍 Book to Skill 的 60 秒短视频。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;需要包含标题、开头钩子、脚本结构、核心画面和结尾行动指令。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h3 id=&#34;3-检查现有脚本&#34;&gt;3. 检查现有脚本&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt; 1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 3&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 4&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 5&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 6&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 7&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 8&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt; 9&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;10&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;11&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;请按照书中的评估标准，检查这份短视频脚本。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;重点分析：&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;1. 标题点击潜力&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;2. 前 3 秒吸引力&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;3. 内容节奏&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;4. 信息密度&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;5. 留存风险&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;6. 惊喜点&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;7. 可以删除的内容&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;8. 具体修改方案&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h3 id=&#34;4-查询书中概念&#34;&gt;4. 查询书中概念&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;请解释书中关于内容留存的核心方法，并说明它适合在哪些场景使用。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;h3 id=&#34;5-重写脚本&#34;&gt;5. 重写脚本&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;2&#xA;&lt;/span&gt;&lt;span class=&#34;lnt&#34;&gt;3&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;请根据书中的原则重写这份脚本。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;保留原来的主题，但增强开头吸引力、内容节奏和结尾转化。&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&lt;p&gt;这时，AI 的判断依据不再只是通用知识，而是你提供的那本书中提取出来的框架。&lt;/p&gt;&#xA;&lt;h2 id=&#34;book-to-skill-真正适合哪些人&#34;&gt;Book to Skill 真正适合哪些人？&#xA;&lt;/h2&gt;&lt;p&gt;这个工具比较适合以下用户：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;经常阅读技术书或商业书的人&lt;/li&gt;&#xA;&lt;li&gt;想把读书笔记真正用于工作的人&lt;/li&gt;&#xA;&lt;li&gt;内容创作者和短视频运营人员&lt;/li&gt;&#xA;&lt;li&gt;产品经理与项目负责人&lt;/li&gt;&#xA;&lt;li&gt;开发者和技术团队&lt;/li&gt;&#xA;&lt;li&gt;需要频繁查询公司内部文档的团队&lt;/li&gt;&#xA;&lt;li&gt;想建立个人 AI 知识库的人&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;如果你只是想快速知道一本书讲了什么，普通的 AI 总结已经足够。&lt;/p&gt;&#xA;&lt;p&gt;如果你希望 AI 在未来的任务中持续使用书里的方法，Book to Skill 会更有价值。&lt;/p&gt;&#xA;&lt;h2 id=&#34;使用时需要注意什么&#34;&gt;使用时需要注意什么？&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-不要把它当成万能知识转换器&#34;&gt;1. 不要把它当成万能知识转换器&#xA;&lt;/h3&gt;&lt;p&gt;生成效果取决于原始文档质量。&lt;/p&gt;&#xA;&lt;p&gt;扫描模糊、排版混乱、缺少文字层或章节结构不清晰的 PDF，可能会影响内容提取结果。&lt;/p&gt;&#xA;&lt;h3 id=&#34;2-重要结论仍需回到原文核对&#34;&gt;2. 重要结论仍需回到原文核对&#xA;&lt;/h3&gt;&lt;p&gt;Skill 可以帮助查找、整理和应用知识，但不代表生成结果一定完全准确。&lt;/p&gt;&#xA;&lt;p&gt;涉及专业决策、法律、医疗、财务或重要商业问题时，应重新核对原始章节。&lt;/p&gt;&#xA;&lt;h3 id=&#34;3-注意版权与使用权限&#34;&gt;3. 注意版权与使用权限&#xA;&lt;/h3&gt;&lt;p&gt;建议只处理以下资料：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;自己购买并合法取得的电子书&lt;/li&gt;&#xA;&lt;li&gt;自己创作的内容&lt;/li&gt;&#xA;&lt;li&gt;公司授权使用的内部文档&lt;/li&gt;&#xA;&lt;li&gt;开放许可资料&lt;/li&gt;&#xA;&lt;li&gt;已进入公共领域的作品&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;不要随意转换、传播或公开分享无权处理的受版权保护内容。&lt;/p&gt;&#xA;&lt;h3 id=&#34;4-敏感文件应谨慎处理&#34;&gt;4. 敏感文件应谨慎处理&#xA;&lt;/h3&gt;&lt;p&gt;项目官方说明，Book to Skill 主要在本地读取文档并写入 Skill 目录，不会主动上传文件或运行网络服务。&lt;/p&gt;&#xA;&lt;p&gt;不过，最终生成和调用 Skill 时是否会把内容发送给云端模型，还取决于你使用的 AI 工具和模型服务。&lt;/p&gt;&#xA;&lt;p&gt;处理公司机密、客户资料或个人隐私文件前，应先确认对应 AI 服务的数据政策。&lt;/p&gt;&#xA;&lt;h3 id=&#34;5-不要直接相信网络视频中的-star-数量&#34;&gt;5. 不要直接相信网络视频中的 Star 数量&#xA;&lt;/h3&gt;&lt;p&gt;GitHub Star 会随时间变化。&lt;/p&gt;&#xA;&lt;p&gt;与其在文章中写死“6.9K Star”或其他数字，不如直接查看项目仓库中的实时数据，避免文章发布后很快过时。&lt;/p&gt;&#xA;&lt;h2 id=&#34;我的理解&#34;&gt;我的理解&#xA;&lt;/h2&gt;&lt;p&gt;Book to Skill 最有价值的地方，不是帮助我们更快地“读完一本书”，而是改变书籍知识的使用方式。&lt;/p&gt;&#xA;&lt;p&gt;过去，一本书读完之后，真正能记住和使用的内容可能很少。&lt;/p&gt;&#xA;&lt;p&gt;现在可以把书里的框架、规则和方法整理成一个 Agent Skill，让 AI 在写作、分析、策划和决策时按需调用。&lt;/p&gt;&#xA;&lt;p&gt;它相当于把一本静态的电子书，变成一个可以查询、分析并参与工作的知识模块。&lt;/p&gt;&#xA;&lt;p&gt;不过，它并不能代替阅读本身。&lt;/p&gt;&#xA;&lt;p&gt;真正合理的用法，是让 AI 帮助我们定位知识、理解框架和应用方法，再回到原文核对上下文。这样既能提高学习效率，也能减少断章取义和错误理解。&lt;/p&gt;&#xA;&lt;h2 id=&#34;项目地址&#34;&gt;项目地址&#xA;&lt;/h2&gt;&lt;p&gt;GitHub：&lt;/p&gt;&#xA;&lt;p&gt;&lt;a class=&#34;link&#34; href=&#34;https://github.com/virgiliojr94/book-to-skill&#34;  target=&#34;_blank&#34; rel=&#34;noopener&#34;&#xA;    &gt;https://github.com/virgiliojr94/book-to-skill&lt;/a&gt;&lt;/p&gt;&#xA;&lt;p&gt;项目名称：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;div class=&#34;chroma&#34;&gt;&#xA;&lt;table class=&#34;lntable&#34;&gt;&lt;tr&gt;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code&gt;&lt;span class=&#34;lnt&#34;&gt;1&#xA;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#xA;&lt;td class=&#34;lntd&#34;&gt;&#xA;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-text&#34; data-lang=&#34;text&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;virgiliojr94/book-to-skill&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#xA;&lt;/div&gt;&#xA;&lt;/div&gt;&#xA;    &lt;blockquote&gt;&#xA;        &lt;p&gt;项目功能、安装方式和兼容范围可能继续更新，请以 GitHub 仓库中的最新 README 为准。&lt;/p&gt;&#xA;&#xA;    &lt;/blockquote&gt;&#xA;</description>
        </item></channel>
</rss>
