A complete learning teardown for Codex Skill
Skill Web Profiler:把 Skill 拆成可学习、可执行、可验证的方法
为任意 Codex Skill 创建完整中文学习与拆解网页。用于分析、解释、教学、反向拆解、做 Skill 手册、生成完整源码档案、提炼精华、工作流、checklists、prompt 模板、决策树、示例和可搜索 references。
Archive
Overview
这个 Skill 解决的问题
为任意 Codex Skill 创建完整中文学习与拆解网页。用于分析、解释、教学、反向拆解、做 Skill 手册、生成完整源码档案、提炼精华、工作流、checklists、prompt 模板、决策树、示例和可搜索 references。
One Sentence Method
一句话心法
Operating Constitution
核心原则:它如何约束 Codex 的行为
使用这个 Skill,把另一个 Skill 文件夹变成一个自包含的中文学习网页。网页的目标是让读者通过浏览页面就能理解目标 Skill 的用途、触发条件、工作流、文件组成、核心红线、最有价值的方法论,并能搜索阅读完整原文档案。
这个 Skill 的产物不是“自动摘要页”,而是“策展后的学习手册”。生成网页时必须同时满足两层:
正文学习层**:用清楚中文把目标 Skill 的用途、判断、流程、红线、资源用法和练习方法讲明白。不能把 SKILL.md 的 Markdown 源码、标题结构、星号、表格碎片直接贴到正文里。
如果正文出现“标题结构:# ... / ## ...”、粗体源码、中英文混杂但没有解释、原文碎片堆叠、卡片只截取一句话却讲不清含义,视为失败,必须重写为人工可读的中文说明。
生成一个本地 HTML 网页,必须包含:
3. 核心原则:从硬规则、红线、fallback、验证要求里提炼行动原则。
默认网页应采用接近手工学习页的 20 栏信息架构:
如果多个路径同名,默认优先 ~/.codex/skills/<name>,除非用户指定其他路径。
Workflow
完整工作流地图
正文学习层**:用清楚中文把目标 Skill 的用途、判断、流程、红线、资源用法和练习方法讲明白。不能把 SKILL.md 的 Markdown 源码、标题结构、星号、表格碎片直接贴到正文里。
3. 核心原则:从硬规则、红线、fallback、验证要求里提炼行动原则。
4. 详细工作流:从 SKILL.md 和关键 references 中抽取步骤、路线、输入、输出和验证。
10. 验证结果:能访问本地页面,关键 archive 数据完整,必要时提供截图或浏览器检查。
重要模块必须写成可教学文案,不要只复制栏目大纲。尤其是“这个 Skill 解决的问题”“核心原则”“工作流地图”“详细步骤”“Fallback”“技术红线”,必须能让第一次看到的人读懂。
5. **本地访问与验证
至少检查首屏、总览、核心原则、工作流、Assets/Demos、完整档案。发现标题竖排、卡片溢出、横向滚动、文本被截断、源码碎片进入正文,都要修复后再交付。
工作流地图:步骤必须清楚,能按顺序执行。
Operational Manual
从接到任务到交付:逐步执行细节
开工前问题模板
Core Protocol
关键协议:先把可靠输入固定下来
Fallback Advisor
Fallback 路线:需求模糊时如何仍然推进
Modes
能力模式:不同任务进入不同角色
Specialized Rules
专项规则:不同产物的不同检查方式
Anti Pattern
反模式细则:什么行为会让 Skill 失效
Exception Handling
异常处理:缺文件、缺上下文、缺工具时怎么做
Technical Redlines
技术红线与交付要求
Showcase Assets
可直接观察的资源样本
File System
文件组成:它不是一段 prompt,而是一套资源包
References
References 路由表
Scripts
Scripts 工具链:哪些工作应该交给确定性脚本
Assets & Demos
素材、模板、示例和 agent 配置
Guardrails
使用边界与红线
How To Use
如何调用这个 Skill
Essence
精华提炼:这个 Skill 最值得学会的东西
Learning Toolkit
学习工具箱:照着练,直到会用
任务决策树
Prompt 模板库
常见错误对照表
可勾选 Checklists
Reference 阅读顺序
术语表
练习题
如果我是 Codex,我会怎么做
Complete Archive