单文件产出知识参考库

定位

本技能是 Universal Task OS 的领域负载物仓库，不包含任何执行框架。只提供单文件产出（HTML单文件应用 / Python单文件CLI工具）的"是什么"和"长什么样"——执行全部委托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. 委托UTOS：将产出类型清单作为清单法输入、范本作为样本法输入、依赖拓扑作为管线编排输入，交给UTOS执行轴+内容轴处理
5. 范本即代码：本技能的exemplars是可直接运行/预览的完整代码文件，非文档描述

与UTOS的接口

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

• Step 0 三轴判定：
  • 简单产出（如计算器）→ 简单+结构化 → 执行轴+内容轴
  • 复杂产出（如游戏）→ 中等+创新+结构化 → 三轴全开
  • 工具链（多个子命令串联）→ 复杂+结构化 → 执行轴+内容轴
• Step 1 领域校准：单文件产出=高规范性(R4)+高迭代性(R5) → G权重高（代码必须能运行），循环多（迭代调试），A权重高（直接产出代码）
• Step 2 内容轴：清单法用本技能的structure-requirements；样本法用本技能的exemplars（代码级样本）
• Step 3 执行轴：管线编排基于本技能的依赖拓扑自动推导元操作序列
• Step 4 交付：G类守护单元自动插入质量检查点（语法验证、功能测试、浏览器兼容性）

单文件产出的核心原则

自包含性（Self-Contained）

两大家族

组合与扩展

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

• HTML嵌套：一个HTML页面通过iframe嵌入另一个
• Python子进程调用：一个Python脚本的子命令调用另一个脚本
• HTML→Python桥接：HTML前端调用本地Python后端（通过简单HTTP或文件交换）
• 管道串联：多个Python CLI工具通过Unix管道 | 串联

域概览

按产出功能类型组织，共7域52种产出类型：

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