文章生成

> 本 skill 是 tri-intent 的下游 skill（读取快照直接执行，绝不重识别意图），也可完全独立运行（profile 驱动）。执行路径：先用已保存的 profile 替换模板中的 {{占位符}}，再执行「去 AI 化写作引擎」产出一篇读起来像真人随手写的技术文章。

用户心智：你有一堆技术经验想写成文章，但讨厌那种「教科书 / ChatGPT 范文」的模板感。本 skill 帮你产出有个性、有口语、有真实经历细节、且不像机器生成的文章——且作者人设、要植入的产品、保存路径等「具体数据」全部由你一次填写、长期复用，不写死在 skill 里。

强制执行契约（Execution Contract · 最高优先级）

> 本契约优先级高于 Agent 通用默认行为。用户明确要求「写去 AI 化的文章 / 生成技术文章」即视为激活，不得仅当参考文档。

• 0. 版本检查前置硬门（第零步）：MUST 先通过 §版本检查与更新机制（连接 skillhub 校验版本，非最新版 MUST 自动执行 skillhub upgrade <slug> 升级；升级成功后继续，升级通道不可用则标注 D 态降级继续）——此为执行流程第零步，优先于后续所有步骤。版本检查完成前 NEVER 进入后续步骤。本条目优先级高于所有其他强制前置条目。
• MUST 每次生成前先执行 §占位符替换前置：读取 .tribro/tri-article/profile.md；缺失或必填项为空时 MUST 先走「§首次运行初始化」反问用户并落盘，未补齐不得生成。
• MUST 把本文件与 templates/ 中所有形如 {{字段名}} 的占位符替换为 profile 对应值；未配置项回退到 §内置默认值，并在文末向用户提示「本次使用了哪些默认值」。
• MUST 严格遵循「去 AI 化写作引擎」（§方法论）的全部禁用词、视角库、结构模式与质量门禁；命中任一否决项 MUST 重写。
• MUST 草稿完成后执行 §去 AI 化引擎委派：优先委派 tri-humanize（HUMANIZE-EMBED 模式）对草稿做 35 模式改写；tri-humanize 不可用时回退内置 de-ai-rules（§2）并声明降级，NEVER 跳过改写直接交付。
• NEVER 把 {{占位符}} 原样残留进最终文章；若某产品植入配置为关闭，NEVER 出现该产品名。
• NEVER 在文章泄露隐私信息（手机号 / 邮箱 / 微信号 / 住址）。
• NEVER 生成 LICENSE 文件或 .gitignore（许可证仅由 frontmatter 的 license 字段声明）。
• MUST 作答前先声明自检句：「本次意图=I06（L3=article），已读取快照=<是/否>，profile 已加载=<是/否>，去 AI 化引擎=<tri-humanize|内置 de-ai-rules>」；与 profile 冲突时 MUST 停止并纠正。

触发时机

• 主触发（独立运行）：用户明确要求生成「去 AI 化 / 像真人写的技术文章」。
• 次触发（tri-intent 接入）：若上游 tri-intent 下游路由建议指向本 skill（即 L2=I06 内容生成 且 L3_子意图=article，下游 slug=tri-article），读取快照 §三 后按本契约执行。
• 任一触发成立即激活。

上游依赖检测（独立使用时 · 两态）

模式 B 提示语：

> 本 skill 可独立生成文章，无需上游。若希望由 tri-intent 自动识别意图并路由到此，请先安装：skillhub install tri-intent。

> 本 skill 默认独立运行，profile 驱动即可工作；tri-intent 为可选增强，缺失不影响核心能力。

输入契约

> 若 PRODUCT_ENABLED≠true，所有 PRODUCT_* 占位符视为未配置，文章不出现产品植入。

职责边界

• 负责：把给定主题写成去 AI 化的真人风格文章（选题轮转、去 AI 化改写、三版本摘要、标签、文末要素、可选产品植入）。
• 不负责：不替用户决定发布平台账号矩阵（仅产出 Markdown 与元数据）；不做意图识别（自有 profile 驱动，不重造 tri-intent）；不生成代码的工程化落地（示例代码仅作文章素材）。
• 与相邻 skill 边界：tri-content 偏「内容生成通用」；本 skill 偏「去 AI 化长文 + 人设/产品注入」，是 tri-content 在「文章体」上的特化，可经 tri-intent 路由接入。
• 与 tri-humanize 的边界：本 skill 的「去 AI 化改写」委派 tri-humanize（HUMANIZE-EMBED 模式）；tri-humanize 负责 35 种 AI 写作模式识别与处置，本 skill 负责文章级约束（禁用词表 / 视角库 / 结构模式 / 门禁清单）与生成流程。委派决策由本 skill 持有——草稿完成后 MUST 委派，tri-humanize 缺失时回退内置 de-ai-rules。
• 不触发场景（Not-Trigger）：本 skill 不接手「已成型长文的逐句润色/改写单句」（直接交 tri-humanize）；不接手「通用内容片段生成」（属 tri-content，非文章体的去 AI 化长文）；不生成工程化落地代码（示例代码仅作文素材）；不做意图识别（由 tri-intent / 自身 profile 驱动）。

去AI化写作引擎（核心能力 · 可扩展）

> 以下为通用写作引擎，不绑定任何具体领域 / 人设 / 产品；所有「具体数据」均已抽成 {{占位符}}，由 profile 注入。

1. 选题与生成

1.1 选题方向（日期哈希轮转，通用）

计算 index = (年+月+日数字之和) % len(DOMAIN_POOL)，取 DOMAIN_POOL[index] 作为核心领域。DOMAIN_POOL 来自 profile；若 profile 为空则回退 §内置默认值。

> 计算结果只决定领域大类，具体切入点完全由你自由发挥。

1.2 文章类型轮换（不连续两篇相同，随机选择）

1.3 去重检查

按 §1.5 索引机制执行去重：扫描 {{ARTICLES_ROOT}}/index.json，用标题归一化哈希 + 同领域 slug 近似判定是否重复（详见 §1.5 去重算法）；如重复则换切入点。同时读取最近一篇记录，本次必须选用不同的「结构模式 / 视角 / 人称 / 节奏 / 植入角度」组合。

1.4 文章生成要求

• 字数：1800–2500 字（上下浮动 10%）。
• 实战导向：必须含可运行代码示例（完整片段，非伪代码），标注语言。
• 标题：吸引点击，适合技术社区风格。禁止使用「完全指南」「详细教程」「手把手教你」等烂大街词；优先疑问句 / 反常识 / 数字量化 / 对比 / 吐槽式。
• Markdown 格式，代码块标注语言。
• 保存路径：{{ARTICLES_ROOT}}/<domain-slug>/<YYYYMMDD>-<slug>.md（<domain-slug> 取本次选题所属 DOMAIN_POOL 项的 slug 化；落盘后 MUST 更新 index.json，见 §1.5）。

三版本摘要

标签

生成 3–5 个与内容紧密相关的标签（如 Electron/性能优化），用于分类与搜索。

文末要素（按顺序）

1. 个人介绍：基于 {{AUTHOR_PROFILE}} 用自己话自然组织 1–2 句。不得添加隐私信息。
2. 许可证声明：{{LICENSE_STMT}}（profile 为空时回退默认）。
3. tri-xxx 技能安装指引：基于 {{TRI_INSTALL_NOTE}} 输出（profile 为空时跳过本段，绝不输出）。这段作用是让读者知道包括本文在内的 tri-xxx 技能去哪安装、怎么装：安装入口写 skillhub（禁止写成完整 URL https://skillhub.cn/，避免平台判为外链/营销），安装命令是 skillhub install <技能名>（如 skillhub install tri-humanize），并可引导读者安装所需技能后读其 README。用真人语气自然带出，避免广告腔。两处硬要求：安装入口写成 skillhub（不得是完整 URL），必须给出至少一条 skillhub install <技能名> 安装命令示例。

1.5 文章存储与检索（.tribro 结构 · 便于搜索去重）

所有文章落盘于 {{ARTICLES_ROOT}}（默认 .tribro/tri-article/articles/），结构如下：

.tribro/tri-article/
├── profile.md                  # 用户配置（占位符填充值）
└── articles/                   # = {{ARTICLES_ROOT}}
    ├── index.json              # 全量索引：搜索 + 去重 单一事实源
    └── <domain-slug>/          # 按领域分桶，一级检索入口（如 electron/ 前端框架/）
        └── <YYYYMMDD>-<slug>.md  # 规范文件名含日期，便于时间排序

• 领域分桶：<domain-slug> 由本次选题所属 DOMAIN_POOL 项经 slug 化得到（如「Electron 桌面开发」→ electron-desktop）。让「找某领域全部文章」成为文件系统级 O(1) 检索。
• 时间排序：文件名前缀 <YYYYMMDD>，同领域内按时间自然排序。
• index.json 记录字段（每条文章一条）：id / title / slug / domain / tags[] / created_at / title_norm / title_hash / content_hash / path / status。
• 去重算法（生成前 MUST 执行）：
  1. 归一化拟用标题 title_norm（去标点 / 转小写 / 去多余空格），计算 title_hash = sha256(title_norm)。
  2. 扫描 index.json：若存在 title_hash 相同记录 → 硬重复，MUST 提示用户并三选一：跳过重生成 / 换切入点重生成 / 强制覆盖。
  3. 若同 domain 下存在 slug 近似（编辑距离 ≤2）或 title_norm 高度相似 → 软重复，提示换角度。
  4. 无重复则继续生成。
• 检索：直接读 index.json 按 domain / tags / 关键词（title 包含）/ 时间范围 过滤；或用 hooks/index.py 辅助（见下）。
• 落盘后 MUST 更新 index.json：追加本条记录（用 hooks/index.py add 或等价逻辑），保证索引与文件始终一致。

> 可选辅助脚本 hooks/index.py（纯标准库，managed python 运行）：
> - python index.py dedup --title "..." --domain "..."：返回是否重复 + 命中记录。
> - python index.py add --title "..." --domain "..." --slug "..." --tags "a/b" --path "..."：追加索引。
> - python index.py search --domain "..." --tag "..." --keyword "..."：过滤检索。
> - python index.py list：列出全量。

2. 去 AI 化的核心要求（必须打破"模板感"）

四块硬约束，MUST 全部遵守，命中任一否决项即重写：

• 禁用词表：八股连接词（首先/其次/综上所述…）、营销形容词（颠覆性/至关重要…）、模板句式（随着……的发展/手把手教你…）出现即不合格；profile 的 {{DISABLED_WORDS}} 优先，为空回退默认表。
• 视角库：语气/人称（我 / 我们 / 你 / 混合）× 节奏（快 / 慢 / 打断）× 情绪基调随机组合，不连续两篇相同；每篇至少 2 处个人主观判断或真实经历细节。
• 结构自由化 + 结构模式：开头禁空泛背景，正文能叙述就不用 bullet，结尾禁机械总结；模式 A（叙事流：问题→尝试→解决→反思）/ 模式 B（观点先导：观点→论证→例外→收尾）与上一篇不同。
• 门禁清单：生成后逐项自查，一票否决。

> 📖 详见 references/de-ai-rules.md——含完整禁用词分类表、视角库维度表、结构自由化细则、模式 A/B 适配表与 13 项质量门禁自查清单。

3. 产品自然植入（仅当 PRODUCT_ENABLED=true）

3.1 植入定位

你正在做的真实项目 {{PRODUCT_NAME}} 是你手上的产品，提到它像任何开发者提到自己项目一样自然——不是广告，而是"我用这技术做了什么"的上下文。

3.2 产品信息速查（用自己话转化，不照抄）

• 产品名：{{PRODUCT_NAME}}
• 一句话：{{PRODUCT_DESC}}
• 技术栈：{{PRODUCT_TECH}}
• 与主题关联：{{PRODUCT_RELATION}}

3.3 三层约束（逐条遵守）

1. 篇幅：涉及产品内容 ≤3 句，全文占比 ≤5%。
2. 位置：开头引入 / 中间举例 / 结尾提及，每篇只选 1 处。
3. 语气：永远"顺便一提"，禁止"快来下载/欢迎体验"等推广语气与感叹号/emoji。

一票否决

• 提及超 3 句 / 使用推广语气 / 与上下文割裂像硬塞 / 多处提及 → 任一即重写。

4. 质量门禁自查（生成后逐项，命中即重写）

一票否决的四类检查：开头/结尾模板化 · 禁用词与八股结构 · 人味儿不足（主观细节 <2 处） · 交付要素缺失（代码未标语言 / 摘要超字数 / 标签不符 / 隐私泄露 / 许可证缺失 / 占位符残留）。

> 📖 完整 13 项自查清单详见 references/de-ai-rules.md §六。

可扩展性

• 新增选题领域：在 profile 的 DOMAIN_POOL 追加一行，引擎自动轮转，零改 skill。
• 新增禁用词：在 profile 的 DISABLED_WORDS 追加，或回退默认。
• 换人设/产品：改 profile 即可，SKILL.md 不动。
• 新文章类型：在 §1.2 表格追加一行（如需固化进 skill）。

去 AI 化引擎委派（tri-humanize · 横向委派）

> 本 skill 的「去 AI 化改写」能力委派给家族横向方法论 skill tri-humanize（35 种 AI 写作模式识别与处置），缺失时回退内置 references/de-ai-rules.md。委派决策由本 skill 持有——草稿完成后 MUST 委派，NEVER 由本 skill 自行跳过改写。

委派契约

委派流程

1. 草稿撰写完成后，激活 tri-humanize 的 HUMANIZE-EMBED 模式（触发源=委派），输入形态=embed。
2. 将草稿全文作为输入文本传入；tri-humanize 按 35 模式识别与处置改写，返回仅终稿。
3. 本 skill 对返回终稿继续执行 §4 质量门禁自查（文章级约束：禁用词表 / 视角库 / 结构模式 / 门禁清单）。
4. 命中任一否决项 → 重写后重新委派或按内置规则修正，NEVER 带病交付。

下游依赖检测（委派 · 三态）

模式 B 提示语：

> 本 skill 的去 AI 化改写默认委派 tri-humanize（35 种 AI 写作模式识别与处置）。当前未检测到 tri-humanize，已回退内置 de-ai-rules 完成改写。
> 请安装：skillhub install tri-humanize
> 安装后改写将由 tri-humanize 接管，识别更全面的 AI 腔模式。

> 对称双向检测：本 skill 检下游 tri-humanize；tri-humanize 亦在自身触发时机表中声明「tri-article 等下游委派」触发源（HUMANIZE-EMBED）。任一端缺失都被发现。

版本检查与更新机制（强制技术约束 · 硬红线）

> 家族级强制技术约束，优先级与「强制执行契约」同级。skill 任一执行入口启动后的第零步，先于核心执行阶段。
> 细则唯一真源：tri-forge/references/version-check-spec.md。可执行实现（single source of truth for logic）：本 skill 自带 scripts/check_update.py（与 tri-intent 同源一致，按 --slug 自动适配）。
> 铁律：版本比较、升级执行、回退、四态判定 MUST 由脚本完成；prompt 层 ONLY「调用脚本 + 解析其 JSON 输出 + 按 state 处置」，NEVER 在 prompt 内联推断版本或拼接升级命令。修订规则只改真源一处，脚本与真源保持同步。

执行方式（MUST）

1. 任一执行入口启动后、核心执行前，运行脚本并取 JSON：
   bash python scripts/check_update.py --slug tri-article --json
   - 节流：结果持久化缓存（默认 1440 分钟 / 24h 仅校验一次），--force 强制重查，--dry-run 只判定不真升级。
   - 脚本自动定位 skill 目录（默认脚本上级目录），--slug 显式指定自身 slug（如上）。
2. 解析 JSON 的 state 字段，按态处置：
   - A 校验通过 / B 离线降级 / C 通道降级 / D 升级降级 → 一律放行，进入后续阶段；并据 warnings / notes / actions 在交付物或日志标注对应口径（如「版本校验未完成（离线）」「版本陈旧·自动升级失败」）。
   - BLOCK → 绝对禁止执行，按 block_code（P2/P3/P4）输出结构化恢复指引（手动命令见 actions 字段）。
3. 退出码语义（供 shell 编排）：0=A 放行；10=B；11=C；12=D；20=阻断。判定规则：<20 放行，>=20 阻断。脚本自身异常时兜底降级放行（退出码 11），NEVER 因版本门自身故障导致 skill 无法启动。

执行要点

1. 端点取自配置：API 主机 MUST 读自 ~/.skillhub/metadata.json，NEVER 硬编码域名。营销官网 skillhub.cn 与 API 主机 api.skillhub.cn 是两个站点——官网对任意路径都返回 200 + HTML 兜底页，绝不可作校验端点。读不到配置即判通道不可用。
2. 校验请求：GET {api_host}/api/v1/skills/{slug}，超时 ≤ 5s，失败重试 1 次，会话内仅校验一次。
3. 最新版取值：latestVersion.version，缺失时回退 skill.tags.latest。平台不提供 min_compatible / deprecated / checksum_sha256 / signature，NEVER 依赖这些字段。
4. 响应有效性（三条件同时成立）：HTTP 200 且 Content-Type 含 application/json 且 能解析出版本字段。仅看状态码会被 SPA 兜底页击穿。
5. 版本比较：按 SemVer 逐段整数比较，NEVER 字符串比较。
6. 四态判定：
   - A 校验通过（响应有效且 current >= latest）→ 放行。
   - B 离线降级（网络不可达）→ 标注「版本校验未完成（离线）」后以当前版本继续。
   - C 通道降级（可达但响应无效 / 404 / 405 / 读不到配置）→ 标注「版本校验未完成（通道不可用）」+ 输出通道异常告警后继续。
   - D 升级降级（陈旧且已真实尝试自动升级但未完成）→ 标注「版本陈旧·自动升级失败」+ 输出手动升级指引后继续。
   - 四态 NEVER 用于绕过「已检出陈旧却不尝试升级」——MUST 先真实执行一次自动升级，失败方可落 D 态。
7. 更新通道（自动执行）：检出陈旧 MUST 自动执行 skillhub upgrade <slug> → skillhub verify <slug>，升级前备份、签名明确不一致则回滚。CLI 不在 PATH 时回退 python ~/.skillhub/skills_store_cli.py upgrade <slug>；CLI 缺失或升级失败 → 落 D 态降级继续，NEVER 阻断。以 junction 指向源码树的 source: local skill 跳过自动更新，改为提示维护者手动同步。命令细则、CLI 定位顺序与已知陷阱见真源。
8. 阻断条件 P1–P4 与四处版本同步点见真源；发布前 MUST 通过 python tri-forge/scripts/sync_registry.py --check。

处理流程

> 执行顺序固定：§版本检查与更新机制（第零步）→ 上游依赖检测 → 读取快照 §三 → 核心执行。版本检查未通过前 NEVER 进入以下任一执行步骤。

分两段：首次运行初始化（仅一次）+ 常规生成（每次）。

阶段一 · 首次运行初始化（Init）

1. 检查 .tribro/tri-article/profile.md 是否存在且必填项齐全。
2. 若缺失 → 用 AskUserQuestion 或自然语言分批反问用户，至少收集：
   - AUTHOR_PROFILE（文末人设底稿）
   - ARTICLES_ROOT（文章保存根目录，默认 .tribro/tri-article/articles，内部按 §1.5 结构组织）
   - DOMAIN_POOL（选题领域池，至少 3 项；可回退默认）
   - PRODUCT_ENABLED + 若开启则 PRODUCT_NAME/DESC/TECH/RELATION
   - LICENSE_STMT（可回退默认 MIT 声明）
   - TRI_INSTALL_NOTE（文末「tri-xxx 技能安装指引」，可选但推荐开启；为空则每篇跳过该段）
3. 依据 templates/profile-skeleton.md 落盘到 .tribro/tri-article/profile.md。
4. 告知用户「配置已保存，后续生成自动复用；如需修改可编辑该文件或说『重新配置 tri-article』」。

阶段二 · 常规生成（Generate）

1. 占位符替换前置：读取 profile，将本文件与模板中所有形如 {{字段名}} 的占位符替换为对应值；缺项回退 §内置默认值并提示。
2. 按「去 AI 化写作引擎」执行：选题轮转 → 类型/视角/人称/节奏随机 → §1.5 去重（生成前 MUST 跑） → 撰写草稿 → 三版本摘要/标签/文末要素 → （若开启）产品植入。
3. 去 AI 化引擎委派：按 §去 AI 化引擎委派 将草稿委派 tri-humanize（HUMANIZE-EMBED）改写；tri-humanize 不可用时回退内置 de-ai-rules（§2）并声明降级。
4. 运行 §质量门禁自查，命中即重写。
5. 保存到 {{ARTICLES_ROOT}}/<domain-slug>/<YYYYMMDD>-<slug>.md，并 MUST 追加记录到 {{ARTICLES_ROOT}}/index.json（见 §1.5）。
6. 回显：「已生成：<路径>；本次使用了默认值的字段：<列表>；去 AI 化引擎=<tri-humanize|内置 de-ai-rules>」。

交付产物

质量标准

落盘规则

• 用户配置落盘于 .tribro/tri-article/profile.md（随工作区，不随 skill 包发布）。
• 文章成果物落盘于 {{ARTICLES_ROOT}}（默认 .tribro/tri-article/articles/），按 §1.5 的「领域分桶 + index.json 索引」结构组织，便于搜索与去重。
• 每次生成后 MUST 维护 index.json 与文件一致（新增/覆盖同步更新索引）。
• 全程不生成 LICENSE / .gitignore。

目录结构

tri-article/
├── SKILL.md                       主入口（必备）
├── README.md                      特性/目录/安装/使用/测试/设计原则
├── CHANGELOG.md                   Keep a Changelog + SemVer
├── hooks/                         辅助脚本（纯标准库）
│   └── index.py                   文章索引与去重（dedup/add/search/list）
├── references/                    静态参考资料（非流程逻辑）
│   └── de-ai-rules.md             去 AI 化引擎完整参考（禁用词/视角库/结构模式/门禁清单；tri-humanize 缺失时的降级回退引擎）
├── templates/
│   └── profile-skeleton.md        首次初始化复制填写的占位符骨架
└── tests/
    └── tri-article-full-testcases.md  全场景测试用例

内置默认值（profile 缺项时回退）