01三个核心信念
信念一精简为王
上下文窗口是公共资源——Skill 与系统提示、对话历史、其他 Skill 元数据、用户请求共享同一窗口。默认假设 Claude 已经很聪明，只添加 AI 不知道的信息，示例优于解释。
操作检查：起草完每段内容后自问——删除它，任务会失败吗？不会，就删。
信念二可验证优于描述
「写个合适的 meta description」不是规范，是愿望。规范必须可测量、可自动检查：把每个要求改写为断言，并给出验证命令。
| 模糊描述 ✗ | 可验证规范 ✓ |
|---|---|
| 写个合适的 meta description | Meta description 140-160 字符，用 wc -c 验证 |
| 多放几个内链 | 内链 2-5 个，指向既有索引页面 |
| 图片要有描述 | 每张图 Alt 非空且 ≤125 字符，脚本扫描 |
信念三强制执行
关键项标记 BLOCKING，未通过不能进入下一阶段。这把规范从「建议」变为「闸门」，比「更聪明的模型」更能提升规范遵从度。
02何时使用这个 Skill
- 设计新的 AI Skill（内容生产类优先，方法通用）
- 审查 / 迭代现有 Skill：检查规范是否可读、可验证、可强制执行
- 搭建内容生产流水线：研究 → 生成 → 质检 → 审核 → 发布
- 编写规范文档：SEO-GUIDELINES / WRITING-STYLE / QUALITY-CHECKLIST
01精简为王 · Token 对照
| 写法 | Token | 效果 |
|---|---|---|
| 直接给 pdfplumber 四行示例代码 | ~50 | 即用 |
| 先解释什么是 PDF、为何用它提取文本 | ~150 | 冗余，稀释关键信息 |
02按任务脆弱性设置自由度
比喻：窄桥配悬崖需要护栏（低自由），开阔田野允许多条路（高自由）。
| 自由度 | 适用场景 | 写法 | 示例 |
|---|---|---|---|
| 高 | 多种方式都有效，决策依赖上下文 | 文本式指引 | 写作风格、语气、措辞 |
| 中 | 存在首选模式，允许变体 | 伪代码 / 带参数脚本 | SEO 规范（有首选方案） |
| 低 | 操作脆弱易错，一致性至关重要 | 具体脚本、少量参数 | Meta 长度、Schema.org 结构、文件格式 |
03可验证优于描述 · 转化方法
| 模糊描述 ✗ | 可验证规范 ✓ |
|---|---|
| 写个合适的 meta description | Meta description 140-160 字符，用 wc -c 验证 |
| 标题要抓人 | 标题含 1 个数字或 1 个具体利益点，人工复核 |
| 图片要有描述 | 每张图 Alt 非空且 ≤125 字符，脚本扫描 |
| 多放几个内链 | 内链 2-5 个，指向既有索引页面 |
关键项标记为 BLOCKING：未通过则阻断进入下一阶段（见「质检」页签）。
01三层渐进式加载
| 层 | 内容 | 规模 |
|---|---|---|
| 层 1 | frontmatter（name + description） | ~100 词，常驻上下文 |
| 层 2 | SKILL.md 正文 | <5k 词，触发时加载 |
| 层 3 | bundled resources（references/ scripts/ assets/） | 无限，按需读取 |
SKILL.md 是入口，不是百科全书
- 控制在 500 行以内，像书籍目录：给导航、给决策树、给最关键步骤
- 超过该量级，把细则拆到 references/
- 明确说明何时读取哪个 reference——读者必须知道它们存在及何时用
02模块化拆分
- 拆成单一职责的小文档，不要合并成大杂烩
- 引用仅一层深度：所有 reference 直接由 SKILL.md 链接，不嵌套二级引用
- reference 超过 100 行时，顶部加目录（table of contents）
- 信息只存在一处，不重复
03命名与描述规范
- 命名：动名词形式，动作 + 对象。例：
writing-blog-articles、generating-social-images，避免名词堆叠 - description：写清「做什么」和「何时触发」，用第三人称（会注入系统提示），必须含触发词，不能含尖括号
示例
01五阶段人机协作工作流
点击任意阶段查看 AI / 人工分工细节。
阶段 1：研究规划
明确目标、受众、关键词，拆解成可执行环节。建立 / 读取规范文档（SEO-GUIDELINES、WRITING-STYLE、QUALITY-CHECKLIST）。确认哪些环节 AI 自动化、哪些人工介入。
AI 负责
- 关键词聚类与优先级初排
- 规范文档实例化
人工负责
- 确定目标与受众
- 确认关键词方向
01BLOCKING 强制质检 · 机制四要素
1标记 BLOCKING
在规范文档中，把不可妥协的关键项标为 BLOCKING。示例：内嵌配图 ≥4 张 · 内链 2-5 个 · 外部权威引用 ≥3 个。
2独立执行
质检由专门 Sub-Agent 执行，与生成者分离，避免立场偏差（自审自过）。
3反馈循环
报告失败项 → 修复 → 重跑 → 直到全部通过。失败项必须可见、可追踪。
4闭环设计
产出发布后自动更新依赖状态（内链索引、知识库），保证下次生成基于最新事实。
02检查清单分类（内容生产示例 · 约 19 项）
| 类别 | 检查项 |
|---|---|
| 格式类 | 标题层级正确（H1 唯一，后续按序） |
| 列表 / 段落标记合法 | |
| 代码块有语言标注 | |
| SEO 指标类 | Slug 用搜索词，非营销语言 |
Meta description 140-160 字符（wc -c 验证） | |
| Schema.org 标记存在且合法 | |
内链 2-5 个，指向既有索引页 | |
| 外部权威引用 ≥3 个 | |
| 图片 Alt 非空、宽度合规 | |
| 一致性类 | 与规范文档无冲突（写作风格、术语） |
| 无重复段落 / 重复内容 | |
| 链接类 | 所有内链目标有效 |
| 所有外链可达（避免死链） |
03效果基准（方法论实测数据）
| 质量指标 | 无 BLOCKING | 有 BLOCKING |
|---|---|---|
| 规范执行率 | ~60% | ~95% |
| 一次通过率 | ~20% | ~70% |
| 单篇产出 | ~1 小时 | ~10 分钟 |
结论：强制执行机制比「更聪明的模型」更能提升规范遵从度。关键规则：禁止记忆猜测价格 / 规格——产品对比类文章，定价与参数必须实时抓取官方页面。
01十条方法论自检清单
点击逐条勾选。完成 Skill 初稿后运行此清单；也可作为审查现有 Skill 的评分表。10/10 通过再发布。