Skill Content Fit

什么内容适合写成 Skill

职责边界

这个 skill 只做一件事：判断给定内容是否够格写成 Codex skill。

输出只有两类：

• 通过：内容满足 skill 准入要求，可以进入 skill 命名、边界框定和编写阶段。
• 打回：内容暂时不符合 skill 准入要求，必须补齐缺口后再评估。

NEVER 替不合格内容决定去向。MUST 只说明为什么不适合写成 skill，以及要补什么，unless the user explicitly asks for alternatives.

核心判断

skill 不是知识仓库，而是可重复执行能力。

有误差只是触发学习的信号，不等于一定要创建 skill：

误差 = 发现偏差
skill = 把可重复、可复用的纠偏方法固化下来

只有当某类误差背后暴露的是“可重复改进的流程问题”时，才值得写成 skill。

准入标准

CRITICAL: 结论为“通过”时，MUST 满足 6/6 项准入标准。每一项都 MUST 能从输入材料中摘出或指向至少 1 条证据；不能靠 agent 临场补写。

1. 可重复：能指出未来还会遇到的任务类型、误差类型或高风险场景；不是只描述单次事实。
2. 有触发：包含至少 1 个用户话术、文件类型、任务场景或失败模式。
3. 有流程：包含至少 3 个有序步骤，或 1 个有分支条件的决策树，或 1 份可逐项勾选的检查清单。
4. 可执行：agent 能按材料采取行动；必要工具、脚本、模板、命令或人工动作至少出现 1 类。
5. 可验证：包含至少 1 种验收方式，例如命令退出码、测试结果、文件/字段存在性、产物检查、人工确认人或明确通过标准。
6. 有边界：包含至少 1 条反例、排除项、停止条件或“不该使用”的场景。

高风险或高代价场景可以降低重复次数要求，但 NEVER 降低流程和验证要求。法务、财务、医疗、安全、合规、生产发布等内容即使只出现一次，也 MUST 有稳定步骤和验收方式，才通过。

打回标准

出现任一情况时打回：

• 只是项目当前状态、背景说明、roadmap 或一次性事实。
• 只是事故流水账，尚未提炼出可复用纠偏流程。
• 只是用户临时偏好、情绪、上下文或单次指令。
• 只是单个知识点，例如某个语言特性、API 事实或术语解释。
• 只是不可执行、不可验证的价值判断。
• 只是“写得更好”“减少错误”“提升质量”这类过宽目标。
• 只是工具或代码 bug 的现象描述，没有可复用修复流程。
• 只有结论，没有触发条件、步骤、反例或验收标准。
• 触发场景过窄，未来很难再次遇到。
• 需要读者记住某次事故里的专有名词、文件位置或排障路径才知道怎么用。

NEVER 为打回内容补写假流程。MUST 只列出输入中缺失的字段和需要用户补充的信息，unless the user explicitly asks you to draft a candidate workflow.

评估流程

CREATE A TODO LIST FOR THE TASKS BELOW，并按 1-5 步逐项检查：

1. 识别这段内容想沉淀什么能力：任务执行、错误纠偏、质量检查、产物生成、排障流程，还是只是事实记录。
2. 如果来自误差或事故，先问：这是一次性偏差，还是可重复的流程问题？
3. 检查六个准入标准：可重复、触发、流程、可执行、可验证、有边界。
4. 任一硬条件缺失就打回，并列出必须补齐的最小信息。
5. 全部满足才通过；通过后再进入 skill 命名、边界框定和编写阶段。

输出模板

结论: 通过 / 打回

判断:
- 可重复:
- 触发条件:
- 可执行流程:
- 验证方式:
- 边界和反例:

如果打回:
- 缺失项:
- 需要补充:

如果通过:
- 建议提炼为 skill 的内容:
  - 触发条件:
  - 工作流:
  - 反例:
  - 验收标准:

示例

WRONG: 只有一次事件事实，没有触发条件、可执行流程、验收方式或边界。

输入：

2026-05-28 首页在 Lark 里没有显示预览图，因为 CDN 对图片返回了错误 Content-Type。

输出：

结论: 打回

判断:
- 可重复: 未提供未来会重复出现的任务类型或误差类型。
- 触发条件: 未提供用户话术、文件类型、任务场景或失败模式。
- 可执行流程: 只有事件结果，没有步骤、决策树或检查清单。
- 验证方式: 未提供命令、产物检查、人工验收或明确通过标准。
- 边界和反例: 未提供不该使用的场景。

如果打回:
- 缺失项: 触发条件、可执行流程、验证方式、边界和反例。
- 需要补充: 未来在哪类 social preview 任务中触发、按什么顺序检查 URL/权限/Content-Type、如何验收、哪些情况不适合写成 skill。

输入：

所有 social preview 图片必须是绝对 HTTPS URL，未登录可访问，返回 200 和正确 Content-Type；Lark 目标场景必须用生产 URL 实测。触发于发布前检查 Open Graph/Twitter/Lark 预览图。流程：1. 提取页面 meta 图片 URL；2. 用未登录环境请求图片；3. 检查状态码和 Content-Type；4. 在 Lark 生产链接里实测预览。反例：只修某一次 CDN 配置错误不触发。验收：curl 返回 200 且 Content-Type 为 image/*，Lark 生产 URL 显示预览图。

输出：

结论: 通过

判断:
- 可重复: 发布前 social preview 检查会重复出现。
- 触发条件: Open Graph/Twitter/Lark 预览图发布前检查。
- 可执行流程: 已提供 4 个有序步骤。
- 验证方式: curl 状态码、Content-Type 和 Lark 生产 URL 实测。
- 边界和反例: 只修某一次 CDN 配置错误不触发。

如果通过:
- 建议提炼为 skill 的内容:
  - 触发条件: 发布前检查页面 social preview 图片，尤其是 Lark 预览目标场景。
  - 工作流: 提取 meta 图片 URL，未登录请求，检查 200 和 image/*，用生产 URL 实测。
  - 反例: 单次 CDN 配置修复、没有复用流程的事故记录。
  - 验收标准: 图片 URL 绝对 HTTPS、未登录可访问、返回 200 和 image/*、Lark 生产 URL 显示预览图。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: tranfu-labs
• Source: tranfu-labs/tranfu-skills
• License: MIT

Install and usage instructions live in the source repository linked above.