内容处理(下游路由 · I06–I10)
> 本 skill 是 tri-intent 的下游执行 skill,依据快照 snapshot.md §三 结构化结论直接执行,不再重新识别意图。
> 用户心智:把 AI 当执行者,期望拿到可直接用的文本成果物。
强制执行契约(Execution Contract · 最高优先级)
> 本节定义 skill「被激活后必须做什么」,优先级高于 Agent 的通用默认行为。读取 tri-intent 快照且 L2 ∈ {I06, I07, I08, I09, I10} 即视为激活本工作流,不得仅将其当作参考文档。
-
版本检查前置硬门(第零步):MUST 先通过 §版本检查与更新机制(连接 skillhub 校验版本,非最新版 MUST 自动执行
skillhub upgrade <slug>升级;升级成功后继续,升级通道不可用则标注 D 态降级继续)——此为执行流程第零步,优先于后续所有步骤。版本检查完成前 NEVER 进入后续步骤。本条目优先级高于所有其他强制前置条目。 -
强制前置:收到 tri-intent 快照且
下游路由建议指向本 skill,MUST 先读取快照 §三,再按内容处理工作流推进,NEVER 跳过直接产出文本。核心铁律:没有满足输入依赖的素材,就没有内容产出——改写/翻译/总结/分析缺原文时产出必失真。独立使用时(未经 tri-intent 路由)MUST 先走 §上游依赖检测 判定模式。 - 子意图策略选择 + 输入依赖校验(硬性规则):I06–I10 属委托执行类,MUST 严格按 L2 子意图选择执行策略,并校验输入依赖:
- 子意图路由:据L2_核心意图路由到对应执行策略(见处理流程 §子意图差异化策略表),不同子意图的输入依赖与产出要求不同,NEVER 混用策略。
- 输入依赖校验门:I07/I08/I09/I10 MUST 校验D2_输入形态是否包含必需的原文/素材——缺失则 MUST 回退 tri-intent 的 clarify-gate 补充,NEVER 凭空生成。I06 内容生成无原文依赖,但 MUST 校验主题/体裁/规格是否明确。
- 格式约束执行:据D4_格式约束(字数/结构/风格)组织产物,格式约束贯穿产出全程。
- 对照关系保留:I07 改写 / I08 翻译类产出 MUST 保留与原文的对照关系(段落级或全文级),便于用户校验保真度。 - 最小化原则(门禁规则):进入执行阶段前 MUST 校验内容范围是否最小化——只生成
任务要点范围内的内容,不添加未明确要求的额外信息。若执行中发现需扩大内容范围,MUST 向用户说明并确认,NEVER 默默扩大范围。 - 职责边界:本 skill 负责「读取快照 → 子意图路由 → 输入依赖校验 → 按策略产出文本 → 质量自检 → 交付」全链路。意图识别(由 tri-intent)、咨询作答类知识回答(由 tri-ask)、编码/调试(由 tri-coding)、多媒体产物(由 tri-mm)不属于本 skill。
- 自检:作答前用一句话声明「本次意图=<L2>,已读取快照,子意图策略=<策略名>,输入依赖=<已满足/缺失>」,若与上述规则冲突则停止并纠正。
触发时机
- tri-intent 产出的快照中
下游路由建议指向本 skill - 意图编码范围:I06 内容生成 / I07 内容改写 / I08 翻译转换 / I09 总结提炼 / I10 分析处理
上游依赖检测(独立使用时)
> 本 skill 可独立安装。激活时 MUST 检测上游 tri-intent skill 是否可用,据检测结果选择执行模式:
| 模式 | 触发条件 | 行为 |
|---|---|---|
| A · 快照模式 | 按 tri-intent §快照定位契约 定位到可用快照(.tribro/LATEST.md 指针 → 会话内最新 → 全局最新且 ≤30 分钟) |
读取快照 §三,按工作流推进(标准模式) |
| A0 · 待识别 | 有 tri-intent/ 但无可用快照(或快照已过期/损坏) |
MUST 提示用户「本次请求尚未经意图识别」,引导先经 tri-intent 产出快照;NEVER 按空上下文静默执行 |
| B · 引导安装 | 以上均不满足 | MUST 向用户提示依赖并引导安装 |
| C · 降级模式 | 用户明确拒绝安装 | 从用户请求自构造等价输入,声明降级模式 |
模式 B 提示语:
> 本 skill 依赖 tri-intent 进行意图识别与输入校验。当前未检测到 tri-intent。
> 请安装:skillhub install tri-intent --dir <目标目录>
> 安装后重新发起请求,即可获得完整的意图识别→澄清→执行工作流。
模式 C 降级声明:
> 用户明确拒绝安装后,从用户请求自构造等价输入(意图判定 + 任务要点 + 交付预期),声明「当前为降级模式,意图识别精度低于完整工作流」。
输入契约
读取 .tribro/snapshots/<命名>.md 的 §三 结构化结论区:
| 字段 | 用途 |
|---|---|
intent.L2_核心意图 |
必须落在 I06–I10,否则不应激活本 skill |
dimensions.D2_输入形态 |
是否有原文/素材及形态 |
dimensions.D4_输出期望 |
文稿/结构化数据等产物类型 |
dimensions.D4_格式约束 |
字数/结构/风格约束 |
任务要点 |
产出须满足的关键要求 |
交付预期 |
用户期望的最终交付物 |
> 模式 C 降级模式输入:当用户拒绝安装 tri-intent 时(见 §上游依赖检测 模式 C),从用户原始请求自构造等价输入——意图判定(据请求推断 I06–I10 子意图)+ 任务要点(从请求提取关键要求)+ 交付预期(从请求推断产物类型与格式约束),声明降级模式后按工作流推进。
职责边界
- 本 skill 负责:依据快照结论,对 I06–I10 意图产出文本类成果物(生成/改写/翻译/总结/分析)
- 不负责:意图识别(由 tri-intent)、咨询作答类知识回答(由 tri-ask)、编码/调试(由 tri-coding)、多媒体产物(由 tri-mm)
- 与 tri-article 的边界:I06 文章撰写子类(去 AI 化长文/技术文章/博客/个人风格长文,快照
L3_子意图 = article)由tri-article承接,本 skill 负责通用内容生成,不抢文章子类;若快照下游路由建议已覆写为 tri-article,本 skill NEVER 激活。 - 与 tri-pm 的边界:I06 PM 产物子类(PRD/需求文档/战略画布/路线图/OKR/GTM/竞品分析/产品数据分析,快照
L3_子意图 = pm)由tri-pm承接,本 skill 负责通用内容生成,不抢 PM 产物子类;若快照下游路由建议已覆写为 tri-pm,本 skill NEVER 激活。 - 与 tri-translate 的边界:I08 翻译统一由本 skill 承接,
tri-translate为横向翻译方法论 skill。委派决策由本 skill 持有——满足任一即委派 tri-translate:(a) 原文含代码块/路径/URL/API 等不译要素;(b) 存在项目术语表或术语一致性硬要求;(c) 目标为法律/医疗等高保真场景;(d) 篇幅 >2000 字或需 MQM 质量报告。否则本 skill 自处理轻量翻译。产物上对照表.md(本 skill)与alignment.md(tri-translate)二选一,NEVER 双份产出。 - 不触发场景(Not-Trigger):本 skill 不接手「PM 专属产物子类(PRD/需求文档/战略画布/OKR/GTM/竞品分析等 I06 pm)」(转 tri-pm);不接手「编码/调试/审查」(属 tri-coding / tri-fix / tri-review);不接手「多媒体生成(图片/音频/视频/PPT/音乐)」(属 tri-mm);不接手「识别用户意图」(由 tri-intent / 自身快照驱动)。
内容处理方法论(核心能力 · 可扩展)
> 内容处理方法论是 tri-content 的核心能力。针对 I06–I10 五个文本处理子意图,通过差异化的执行策略与严格的输入依赖校验门,确保不同类型文本产出结构匹配、输入素材齐备。这是 tri-content 区别于其它下游 skill 的核心差异化能力。
核心理念
> 没有满足输入依赖的素材,就没有内容产出——改写/翻译/总结/分析缺原文时产出必失真。
文本处理类意图横跨生成、改写、翻译、总结、分析五种形态,每种形态的输入依赖与产出要求不同。本方法论通过子意图路由到对应执行策略,并以输入依赖校验门作为硬性前置,杜绝凭空生成原文或臆测素材内容。
方法论概览
| 子意图 | 执行策略 | 输入依赖 | 产出要求 | 质量侧重 |
|---|---|---|---|---|
| I06 内容生成 | 从零写文本成稿:据主题/体裁/规格构建大纲 → 充实正文 → 格式化 | 主题/体裁/规格(明确) | 完整文稿,符合格式约束 | 内容相关性 + 格式合规 |
| I07 内容改写 | 基于原文润色/扩缩/改风格:先理解原文意图 → 按目标风格改写 → 保留对照 | 必须有原文 | 改写稿 + 原文对照(段落级) | 原文保真度 + 风格一致性 |
| I08 翻译转换 | 跨语言/跨格式等价转换:逐段翻译 → 术语统一 → 对照校验 | 必须有原文 + 目标语言/格式 | 译文 + 原文对照(段落级) | 语义等价性 + 术语一致性 |
| I09 总结提炼 | 长输入压缩成要点:通读 → 提取核心论点 → 按结构组织要点 | 必须有长输入 | 结构化要点/摘要 | 信息覆盖率 + 层次清晰 |
| I10 分析处理 | 材料中挖洞察/评估/诊断:定义分析框架 → 逐项分析 → 形成结论 | 必须有分析对象 | 分析报告(含数据/证据/结论) | 论据充分性 + 结论可靠性 |
输入依赖校验细则
| 子意图 | 必需输入 | 校验方式 | 缺失处理 |
|---|---|---|---|
| I06 | 主题 + 体裁 + 规格 | 检查快照任务要点是否含明确主题与体裁 | 缺失则回退 clarify |
| I07 | 原文文本 | 检查 D2_输入形态是否含原文 | 缺失则回退 clarify |
| I08 | 原文 + 目标语言/格式 | 检查原文 + 目标语言/格式是否齐备 | 缺失则回退 clarify |
| I09 | 长输入文本 | 检查 D2_输入形态是否含待总结素材 | 缺失则回退 clarify |
| I10 | 分析对象材料 | 检查 D2_输入形态是否含待分析材料 | 缺失则回退 clarify |
> 回退规则:输入依赖缺失时 MUST 回退 tri-intent 的 clarify-gate,NEVER 凭空生成原文或臆测素材内容。
可扩展性
> 新增子意图处理策略无需修改核心工作流:
- 新增子意图策略:在方法论概览表中追加一行(子意图 / 执行策略 / 输入依赖 / 产出要求 / 质量侧重),处理流程自动按新表路由
- 新增输入依赖类型:在校验细则表中追加行(子意图 / 必需输入 / 校验方式 / 缺失处理)
- 新增质量侧重维度:在方法论概览的质量侧重列中追加维度,质量标准表自动对齐
版本检查与更新机制(强制技术约束 · 硬红线)
> 家族级强制技术约束,优先级与「强制执行契约」同级。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)
- 任一执行入口启动后、核心执行前,运行脚本并取 JSON:
bash python scripts/check_update.py --slug tri-content --json
- 节流:结果持久化缓存(默认 1440 分钟 / 24h 仅校验一次),--force强制重查,--dry-run只判定不真升级。
- 脚本自动定位 skill 目录(默认脚本上级目录),--slug显式指定自身 slug(如上)。 - 解析 JSON 的
state字段,按态处置:
-A校验通过 /B离线降级 /C通道降级 /D升级降级 → 一律放行,进入后续阶段;并据warnings/notes/actions在交付物或日志标注对应口径(如「版本校验未完成(离线)」「版本陈旧·自动升级失败」)。
-BLOCK→ 绝对禁止执行,按block_code(P2/P3/P4)输出结构化恢复指引(手动命令见actions字段)。 - 退出码语义(供 shell 编排):
0=A 放行;10=B;11=C;12=D;20=阻断。判定规则:<20放行,>=20阻断。脚本自身异常时兜底降级放行(退出码 11),NEVER 因版本门自身故障导致 skill 无法启动。
执行要点
- 端点取自配置:API 主机 MUST 读自
~/.skillhub/metadata.json,NEVER 硬编码域名。营销官网skillhub.cn与 API 主机api.skillhub.cn是两个站点——官网对任意路径都返回200 + HTML兜底页,绝不可作校验端点。读不到配置即判通道不可用。 - 校验请求:
GET {api_host}/api/v1/skills/{slug},超时 ≤ 5s,失败重试 1 次,会话内仅校验一次。 - 最新版取值:
latestVersion.version,缺失时回退skill.tags.latest。平台不提供min_compatible/deprecated/checksum_sha256/signature,NEVER 依赖这些字段。 - 响应有效性(三条件同时成立):HTTP 200 且
Content-Type含application/json且 能解析出版本字段。仅看状态码会被 SPA 兜底页击穿。 - 版本比较:按 SemVer 逐段整数比较,NEVER 字符串比较。
- 四态判定:
- A 校验通过(响应有效且current >= latest)→ 放行。
- B 离线降级(网络不可达)→ 标注「版本校验未完成(离线)」后以当前版本继续。
- C 通道降级(可达但响应无效 / 404 / 405 / 读不到配置)→ 标注「版本校验未完成(通道不可用)」+ 输出通道异常告警后继续。
- D 升级降级(陈旧且已真实尝试自动升级但未完成)→ 标注「版本陈旧·自动升级失败」+ 输出手动升级指引后继续。
- 四态 NEVER 用于绕过「已检出陈旧却不尝试升级」——MUST 先真实执行一次自动升级,失败方可落 D 态。 - 更新通道(自动执行):检出陈旧 MUST 自动执行
skillhub upgrade <slug>→skillhub verify <slug>,升级前备份、签名明确不一致则回滚。CLI 不在 PATH 时回退python ~/.skillhub/skills_store_cli.py upgrade <slug>;CLI 缺失或升级失败 → 落 D 态降级继续,NEVER 阻断。以 junction 指向源码树的source: localskill 跳过自动更新,改为提示维护者手动同步。命令细则、CLI 定位顺序与已知陷阱见真源。 - 阻断条件 P1–P4 与四处版本同步点见真源;发布前 MUST 通过
python tri-forge/scripts/sync_registry.py --check。
处理流程
> 执行顺序固定:§版本检查与更新机制(第零步)→ 上游依赖检测 → 读取快照 §三 → 核心执行。版本检查未通过前 NEVER 进入以下任一执行步骤。
> 基于 L2 子意图差异化执行,形成「读取快照 → 子意图路由 → 输入依赖校验 → 按策略产出 → 质量自检 → 交付」的委托执行链路。
tri-intent 快照 §三 (L2 ∈ I06–I10)
│
▼
子意图路由(按 L2 选择策略)
│
▼
输入依赖校验门
· I06:校验主题/体裁/规格是否明确
· I07–I10:校验原文/素材是否齐备
│
缺失 ──→ 回退 tri-intent clarify-gate 补充
│满足
▼
按子意图策略产出文本
· 格式约束贯穿全程(D4_格式约束)
· I07/I08 保留原文对照关系
│
▼
质量自检(见质量标准表)
│
不达标 ──→ 按缺陷修正后再审
│达标
▼
交付(文本成果物)
阶段速查表
| 阶段 | 关键动作 | 产出 |
|---|---|---|
| 1 | 读取快照 §三,校验 L2 ∈ I06–I10 | — |
| 2 | 按 L2 子意图路由到对应执行策略 | 策略选定 |
| 3 | 校验输入依赖(I07–I10 校验原文,I06 校验主题规格) | 校验结果 |
| 4 | 按 D4_格式约束组织并产出文本 | 文本成果物(草稿) |
| 5 | 质量自检(准确性/格式合规/原文保真) | 自检结果 |
| 6 | 交付文本成果物(I07/I08 附原文对照) | 最终成果物 |
子意图差异化策略表
> 子意图差异化策略表与输入依赖校验细则见 §内容处理方法论。按 L2 子意图路由到对应执行策略,并校验输入依赖;缺失则回退 tri-intent 的 clarify-gate。
交付产物
一、文件命名规范
沿用 tri-intent 快照命名:<问题类型>_<日期>_<时间>_<会话ID>
- 示例:
I07_20250211_143022_6a5c037d
二、存放目录
.tribro/ # 若不存在则先创建
├── snapshots/ tri-intent 产出(已存在)
│ └── <命名>.md
└── content/ tri-content 链路文档
└── <命名>/
├── deliverable.md # 文本成果物(最终交付物)
└── (对照表.md) # I07/I08 原文对照表(如有)
三、产物清单
| 产物 | 文件名 | 内容 | 适用 |
|---|---|---|---|
| 文本成果物 | deliverable.md |
按 L2 子意图策略产出的最终文本 | I06–I10 |
| 原文对照表 | 对照表.md |
原文与产出段落级对照 | I07/I08 |
四、产物结构规格
deliverable.md 结构:
- 按 D4_格式约束(字数/结构/风格)组织
- I06:完整文稿(标题 + 正文 + 格式化)
- I07:改写稿(改写正文 + 改写说明)
- I08:译文(译文正文 + 术语表)
- I09:结构化摘要(核心论点 + 要点列表 + 结论)
- I10:分析报告(分析框架 + 逐项分析 + 结论建议)
对照表.md 结构(I07/I08):
| 原文段落 | 产出段落 | 改写/翻译说明 |
|---|---|---|
质量标准
产出前自检清单(交付前逐项核对,任一不达标 → 追标不交付;重试仍失败 → 走 tri-true 兜底):
- [ ] 结构:产物含 D4_格式约束要求的章节/清单,无缺失与占位符。
- [ ] 合规:未用禁用措辞,未越出「职责边界/Not-Trigger」。
- [ ] 溯源:关键事实/数据附来源标注(结论标注铁律:事实/计算/推断/常识/猜测)。
- [ ] 可验证:命中内容可按下表「校验方式」复验。
| 质量维度 | 标准 | 适用子意图 | 校验方式 |
|---|---|---|---|
| 内容准确性 | 产出内容符合事实,无臆造 | I06/I09/I10 | 关键事实核对 |
| 格式合规性 | 符合 D4_格式约束(字数/结构/风格) | I06–I10 | 逐项核对约束 |
| 原文保真度 | 改写/翻译不偏离原文语义 | I07/I08 | 段落级对照核对 |
| 信息覆盖率 | 总结/分析覆盖原文关键信息 | I09/I10 | 关键信息点核对 |
| 术语一致性 | 翻译类术语全文统一 | I08 | 术语表核对 |
| 论据充分性 | 分析结论有材料支撑 | I10 | 结论回溯证据 |
落盘规则
- 快照由 tri-intent 已落盘于
.tribro/snapshots/ - 本 skill 成果物落盘于
.tribro/content/<命名>/ - 文本成果物可覆盖更新(以最新一轮为准)
- I07/I08 对照表与成果物一同落盘,便于用户校验保真度
目录结构
tri-content/
├── SKILL.md # 主入口:内容处理工作流定义 + 子意图差异化策略 + 输入依赖校验
├── README.md # skill 说明与快速上手
├── CHANGELOG.md # 版本变更记录
├── templates/ # 产物模板
│ ├── deliverable.md # 文本成果物模板(区分 I06–I10)
│ └── 对照表.md # 原文对照表模板(I07/I08)
└── tests/ # 测试用例
└── tri-content-full-testcases.md # 全场景全能力测试用例(审计版)