100x-skill-tiktok: Instructions file for Codex

100x-skill-tiktok · 项目协作规则

面向在这个仓库工作的 agent（Claude Code / Codex / 其他）。用户全局规则见 ~/.codex/AGENTS.md，那份文件管身份、沟通、授权、安全这些通用规则，不在这里重复。 本文件只写这个仓库专属、长期有效的建造契约：七件套结构、ajv 强制、公理格式、 开源合规红线、不代笔编方法论。

0 · 真源顺序

新会话进这个仓库，先按这个顺序读，不要跳步：

1. 本文件 —— 长期规则，回答"该怎么做"
2. 具体 skill 内部的七件套文档 —— 回答"这个 skill 自己的判据是什么"

1 · 仓库定位与写权限边界

三层架构里的第 2 层，通用能力件，上游是私有数据底座（语料、知识原子），下游是产品项目：

第1层 · 私有数据底座        （语料、知识原子，不进这个仓）
        ↓ requires_data 声明引用，不复制内容
第2层 · 100x-skill-tiktok   ← 本仓 · 框架公开
        ↓ registry 钉版本
第3层 · 产品项目            （实际业务落地）

SKILL.md 是框架，atoms 是数据。前者公开，后者收费。

• 本仓是自包含的，写操作仅限本仓库。 不依赖外部仓库的写权限，所有产出均在当前工作区内完成
• 数据集依赖写在 metadata.json 的 requires_data 字段（如 ["corpus.labeled_transcripts", "taxonomy.hat_copy"]），只声明 id，不复制内容
• 这是公开仓：真实客户语料、真实 transcript、真实账号名/产品名、飞书链接、Base token、API key、客户裁定的品类词典，一律不进仓——具体红线见 §5

2 · 每个 skill 固定七件套

skills/ 全平级，无分类子目录、无编号；100x- 前缀是命名空间，防止装进 ~/.claude/skills/（平铺目录）时撞名。每个 skill 目录内部固定这七个文件/目录，不精简、不新增替代结构：

文件/目录	作用
SKILL.md	入口，Claude Code / Codex 靠这个路由。frontmatter 的 description 必须嵌用户会说的中英文触发词原话——这是 skill 被自动挑中的唯一机制，分类元数据不进这里
metadata.json	结构化元数据：作者、版本、requires_data、validation（ajv 和手写代码的分工说明）
axioms.md	硬约束：每条公理 = 一句话 + 可机器验证断言 + 出处 + 反例作废条件，格式见 §4
workflow.md	生成/判断的具体流程阶段
sources.md	结论来源追溯，如实披露规则来源与本次原创内容
schema.json	输出契约，JSON Schema draft-07，ajv 编译执行
evals/	只放合成样例，真实语料一条都不许进

3 · 校验分层：ajv 强制，手写代码只补结构层管不到的部分

• 结构层约束（required/additionalProperties/enum/pattern 这类 JSON Schema 已经能表达的东西）一律用 ajv 编译执行 schema.json，不允许手写代码重新实现
• 跨条目/跨字段约束（JSON Schema draft-07 表达不了的部分，例如引用完整性、证据必须是原文逐字子串、5A 阶段覆盖率）才用 scripts/validate.js 里的手写代码补，两层各自的职责必须写清楚在 metadata.json.validation 字段里，不能含糊
• 每个 skill 的 node scripts/validate.js --selftest 必须能跑，且带回归用例（反例应该 FAIL 就必须真的 FAIL）

4 · axioms.md 公理格式（四要素，缺一不可）

每条公理照这个格式写，参考仓库里已建成 skill 的 axioms.md：

1. 一句话 —— ≤30 字，脚本量得过的摘要
2. 可机器验证断言 —— 明确写清楚哪部分 schema.json/ajv 能管、哪部分管不住需要 scripts/validate.js 补，两者都要点名
3. 出处 —— 具体方法论文献或标准；如果是本次新定义的规则，必须如实标注"本次原创"
4. 反例（作废条件） —— 什么样的输出会让这条公理判 FAIL，最好对应 --selftest 里的一条回归用例