单文件产出知识参考库

定位

本技能是 Universal Task OS 的领域负载物仓库，提供单文件产出（HTML单文件应用 / Python单文件CLI工具 / Shell单文件脚本 / SQL单文件脚本）的"是什么""长什么样"以及"怎么做"——执行全部委托UTOS。

三层结构

第一层：产出类型清单 + 依赖拓扑 + 选型决策树 + 管线蓝图（域特有扩展）   →  references/output-catalog.md
第二层：结构要求清单 + 自包含约束 + 组装流程 + 质量等级   →  references/structure-requirements.md
第三层：优秀范本库                                      →  references/exemplars.md

依赖声明

本技能强依赖 Universal Task OS (universal-task-os)。没有UTOS，本技能只有参考查阅能力，无法执行任何代码产出任务。

加载检查流程（每次激活时执行）：

1. 检测 universal-task-os 技能是否已安装
2. 未安装 → 自动安装 universal-task-os 技能
3. 安装成功 → 同时加载UTOS，按本技能"使用规则"执行
4. 安装失败 → 降级为只读参考模式：
   • ✅ 允许：查阅产出类型、结构要求、范本索引
   • ❌ 拒绝：任何涉及代码生成、管线编排的任务，并提示"需先安装 Universal Task OS"

任务模式判定：

使用规则

1. 依赖检查：激活时按上述流程检测并安装UTOS
2. 首次加载：读取 references/output-catalog.md，获取产出分类、依赖拓扑、选型决策树、UTOS元操作映射提示
3. 按需深入：确认目标产出类型后，读取 references/structure-requirements.md 获取组件清单、自包含约束、组装流程、质量等级；如需样本法，读取 references/exemplars.md 获取可运行代码
4. 双模式路由：
   • 目录模式：用户指定具体产出类型(S-XX) → 直达structure-requirements组装 → 交付
   • 流程模式：用户描述需求/问题 → output-catalog决策树选型 → structure-requirements组装 → 集成验证 → 交付
5. 委托UTOS：将产出类型清单作为清单法输入、范本作为样本法输入、依赖拓扑+管线蓝图作为管线编排输入、决策树作为选型输入，交给UTOS执行轴+内容轴处理
6. 范本即代码：本技能的exemplars是可直接运行/预览的完整代码文件，非文档描述

与UTOS的接口

当UTOS处理单文件产出任务时：

• Step 0 三轴判定：
  • 目录模式（用户指定S-XX）→ 简单+结构化 → 执行轴+内容轴
  • 流程模式（用户描述需求）→ 中等+结构化 → 执行轴+内容轴（走output-catalog决策树+structure-requirements组装流程）
  • 创新混搭（用户要新组合）→ 中等+创新+结构化 → 三轴全开
  • 管线组合（多产物串联）→ 复杂+结构化 → 执行轴+内容轴（依赖拓扑+管线蓝图推导）
  • 管线创新组合（跨家族桥接）→ 复杂+创新+结构化 → 三轴全开（管线蓝图+创新轴推导新组合）
• Step 1 领域校准：单文件产出=高规范性(R1)+高迭代性(R5) → G权重高（代码必须能运行），循环多（迭代调试），A权重高（直接产出代码）
• Step 2 内容轴：清单法用本技能的structure-requirements；样本法用本技能的exemplars（代码级样本）
• Step 3 执行轴：管线编排基于本技能的依赖拓扑自动推导元操作序列
• Step 4 交付：G类守护单元自动插入质量检查点（语法验证、功能测试、浏览器兼容性）

单文件产出的核心原则

自包含性（Self-Contained）

四大家族

组合与扩展

单文件产出之间可以通过以下方式组合：

• HTML嵌套：一个HTML页面通过iframe嵌入另一个
• Python子进程调用：一个Python脚本的子命令调用另一个脚本
• Shell管道串联：多个Shell脚本通过Unix管道 | 串联
• Shell→Python调用：Shell脚本调用Python CLI工具
• Shell→SQL执行：Shell脚本通过mysql/psql/sqlite3执行SQL
• SQL→Python桥接：SQL查询结果导出CSV/JSON，Python读取处理
• HTML→Python桥接：HTML前端调用本地Python后端（通过简单HTTP或文件交换）

域概览

按产出功能类型组织，共8域37子分类188种产出类型：

完整清单见 references/output-catalog.md。