asimfish/super_agent_presentation

智能体报告化

以最短的结构呈现最新任务状态，让读者能快速找到结果、证据、边界以及有用的下一步操作。此技能仅管理报告呈现；绝不改变任务事实或替代特定领域的验证。

不可协商的优先级

当用户明确指定表面格式、结构、长度和顺序时，必须遵守。然后遵循宿主指令。仅当选择未明确时再使用此框架。 绝不捏造证据、测试、引用、指标、文件、所有者、日期或完成情况。

书签式工作流

1. 根据受众、表面、证据边界和唯一的主要模式对手头任务进行分类。对于研究型工作，最多选择一个领域配置文件。不确定时使用 list 或 route。

2. 根据任务调整仪式。对于简短的单会话回答，不要创建检查点、草稿文件或脚本审计：直接应用路由模式的既定结构，自行检查其必需的语义，然后交付；第 4-6 步中的文件支撑仪式适用于长期、多会话、多智能体或持久性工件的工作。对于长期、多智能体或多会话任务，在开始时保存一个紧凑的检查点；对于简短任务，将路由推迟到报告边界。

3. 完成并验证实际任务。保持任务执行独立于报告样式。

4. 在实质性更新或最终答案之前立即获取一个有界上下文模块。优先选择一个显示模块；仅在主要模式和第一个模块未能满足明确需求时添加第二个模块。绝不要仅仅因为请求的输出命名了所选模式已指定的语义而加载模块：

   将 <skill-dir> 解析为包含此 SKILL.md 的目录；不要假定调用者的工作目录是技能目录。

   python3 <skill-dir>/scripts/reportctl.py bundle \
     --task "<需要传达的内容>" --mode <模式> --surface <表面> \
     [--profile <配置文件>] [--module <模块>] [--module <模块>] \
     --max-chars 16000
   

   如果恢复一个长期任务，传入 --checkpoint <路径> 而非从内存重建路径。--max-chars 是一个独立的上下文预算：一个有效的检查点带有两个大模块可能需要明确指定更大的值。不要读取每个模式、模块或模板。

5. 为所选表面原生起草报告。当路径推荐一个精确的资产时，检查廉价注册表并仅获取一个资产：

   python3 <skill-dir>/scripts/reportctl.py template --list
   python3 <skill-dir>/scripts/reportctl.py template <模板ID> \
     --output <目标路径>
   

   使用一个主要的交付制品；除非要求，否则不要并行创建 Markdown、HTML、PPTX 和 PDF 版本。复制的模板是起始工件，不是其占位符、视觉效果或声明正确的证据。

   内容完成后，进行去 AI 语调处理：砍掉谄媚的开场白、表演性摘要、浮夸行话和模板修辞，遵循 natural-tone 模块的保真合约。语调编辑绝不改变事实、关系、范围或数字；审计的 ai-tone-boilerplate 警告仅捕获最高精度的残留。

   在研究模式（实验报告、学术综述、研究想法）中，还要检查每个成功率是否带有 k/n 和二项置信区间，每个 显著 是否在同一句话中带有检验和效应量，并且没有动词将理解或意图归因于系统。审计的 success-rate-without-denominator、significance-without-statistic 和 anthropomorphic-claim 警告捕获机械残留；配置文件和结论模块包含完整规则。数字呈现在相同模式下有自身的残留检查：unlabeled-uncertainty（一个从未说明 SD、SEM 或 CI 的 ±）、threshold-p-value（p < 0.05、n.s.）、p-value-without-effect-size、null-result-without-interval、significance-euphemism（approached significance）、up-to-without-central-tendency 和 best-of-n-runs。

6. 在长期任务或持久性工件终稿前，对文件支持的草稿进行审计。长期任务必须使用相同的检查点；没有检查点的持久性工件使用其选定的模式：

   python3 <skill-dir>/scripts/reportctl.py audit \
     --file <草稿.md> --checkpoint <检查点路径>
   # 简短、无需检查点的路径：
   python3 <skill-dir>/scripts/reportctl.py audit --file <草稿.md> --mode <模式>
   

   检查点推导出模式。提供相同的显式模式是允许的；冲突的模式是输入错误。修复审计错误。谨慎地解决警告；绝不要仅仅为了满足启发式而添加无支持的填充内容。仓库的 docs/AUDIT-CODES.md 列出了每个代码及其触发条件和修复方法。使用 --json，审计负载包括精确的报告字节数/SHA-256 和解析的检查点意图指纹，用于控制器绑定。

7. 手动验证最新状态、科学或技术声明、数字、证据链接、不确定性、视觉解释以及用户指定的格式。

最终交付

用户可见的最终响应必须包含报告本身。路径、链接或指向已保存草稿、检查点或审计收据的指针不是可交付物：在检查点支持的审计通过后，交付审计后的草稿内容作为响应。当用户明确请求文件时，仍然先在线内给出结果。 绝不要在面向读者的响应中暴露本地绝对路径、暂存目录或检查点位置。

模式与模块选择

使用 python3 <skill-dir>/scripts/reportctl.py list 获取标识符。选择主要的叙述主线，而非每个适用的标签。对于混合任务，选择能回答用户主要决策或问题的模式，并将次要事实嵌入其中。

• 使用 concise-answer 用于直接回答，无需过多支持结构。
• 使用 implementation-handoff 用于构建或更改的制品。
• 使用 status-update 用于项目进度（非活跃事件）。
• 使用 investigation-report 用于诊断或基于来源的调查。
• 使用 experiment-report 用于受控评估和实证比较。
• 使用 decision-brief 或 risk-report 当选择或风险是主要考虑时。
• 使用 academic-synthesis 用于论文或文献展示。
• 使用 research-idea 用于论文想法或提案，其假设、新颖性、决定性实验、风险和终止标准必须保持明确。
• 使用 review-report 用于针对制品或标准的发现。
• 当影响活跃时使用 incident-update；恢复后使用 postmortem。

图表、表格、结论、证据细节和学术展示是正交模块，不是合并多个模式的理由。可视化必须使关系或制品更容易理解；装饰不是一个有效理由。experiment-report 已经包含结果解释、不确定性边界和校准结论。不要仅仅因为请求要求结论而将 conclusions 添加到该模式；仅在确实需要单独的决策或建议策略时才明确添加。

研究配置文件与展示表面

配置文件是一个有界的领域覆盖层，不是额外的首要模式：

• reinforcement-learning：运行核算、调优均等性、学习曲线、区间估计和多任务聚合评估。
• embodied-ai：具身化、传感器/动作、模拟与真实协议、成功规则、干预、泛化和失败。
• world-models：模型/数据卡以及独立开环、闭环、缩放和迁移证据。
• vla：数据混合、形态和动作接口、适应制度、展开核算、延迟、泛化和安全性。

自动选择仅适用于研究导向模式。schema-v2 检查点不存储新的配置文件字段；配置文件从其带指纹的任务文本重新推导。因此，在为长期任务显式选择配置文件时，在检查点任务中命名领域，以便最终检索可重现。

对于 --surface slide，阅读路由幻灯片指南。它提供了论文演讲、研究进展、实验回顾和想法推介叙述。获取无依赖的 HTML/PPT 样式演示文稿或 Quarto Reveal.js 源文件之一，除非用户请求多种格式。

长上下文持久化

不要将完整的报告捆绑包保留在工作上下文中。仅保存一个检查点：

python3 <skill-dir>/scripts/reportctl.py checkpoint \
  --task "<交接目标>" --mode <模式> --surface <表面> \
  --must-show "<简短稳定的文本锚点>" \
  --output <私有暂存>/agent-report.json

Schema-v2 的 --must-show 值是归一化的字面锚点，不是语义要求：审计应用 NFC 归一化、大小写折叠和空白折叠，然后仅在空白行分隔的、列零的、纯文本顶级 Markdown 散文段落中检查字面子串存在。包含标题、引用、列表、表格、链接/引用、图像、代码或原始 HTML 的段落不合格。在第一个未屏蔽的原始 HTML 标签之后，不再有段落获得信用，因为代理不模拟跨段落 DOM 或 CSS 状态；原始 HTML 也是结构性审计错误。每个锚点必须在一个符合条件的段落内匹配。该段落内的软换行折叠为空格，但空白行段落边界永远不会。

在归一化之前，报告代理解码一轮共享扫描器支持的、分号终止的 CommonMark 实体子集，但仅当实体的 & 未被奇数长度的反斜杠序列转义时。产生的控制字符或 Unicode 非渲染字符使检查失败。V2 锚点必须使用精确的渲染纯文本，并拒绝 Markdown 定界符形式。在每个原始 HTML 之前，将每个短锚点放在一个独立的普通结论句子中。此代理不验证文本的含义、谁断言了它，或它是否为真。每个锚点最多 120 个字符，其转义收据（包括分隔符）最多 240 个字符。

检查点支持的审计接受最多 1 MiB 的报告，以便散文代理保持资源有界。任何符合条件的纯文本散文段落超过 4096 个字符或包含超过 64 个连续 Unicode 标记字符的段落被视为错误，并在 NFC 和锚点匹配之前跳过。遗留的仅模式审计保持上限为 4 MiB；当存在 --checkpoint 时，此更大限制不适用。有界 JSON 输入在转换前拒绝超过 128 个字符的整数或浮点令牌。

检查点逐字存储目标、受众、表面、模块和锚点，加上路由元数据和未键控的校验和。校验和检测意外漂移；它们不验证文件。不要在任何字段中放置机密或不必要的私有数据。使用版本控制之外的私有暂存路径，记住 route/bundle 可以将检查点文本重放至标准输出，并在不再需要恢复时删除文件。原子创建在 POSIX 上使用限制性文件权限，但不能保护宽松的父目录、日志、备份或已提交的文件。

在最终边界，使用 bundle --checkpoint <检查点路径> 重新加载它，并运行 audit --file <草稿.md> --checkpoint <检查点路径>。Schema-v1 检查点仍可由 route 和 bundle 读取，但不能驱动此最终关卡；使用 checkpoint --checkpoint <v1路径> --output <新的v2路径> 重建或升级有效的 v1 文件。宿主机识别的微合约旨在提示两个书签；它和检查点都不能强制任意智能体遵守。

持久报告的严格模式

当包装器、批处理工作流或正式报告需要更强的结构一致性时，从 assets/templates/report-spec.json 开始，用 validate-spec 验证，并用 render 确定性渲染 Markdown。将 JSON 视为单一的呈现源，但根据原始证据验证所有事实。每个声明声明一个或多个语义 roles；验证从证据、指标、不确定性、行动和限制中推导出剩余覆盖，然后从协议目录中强制执行所选模式的当前 required_semantics。捆绑的 JSON Schema 是一个可移植的结构预检查，而非 validate-spec 的替代品；只有 CLI 能强制实施 ID 唯一性、跨记录引用和当前协议目录。

python3 <skill-dir>/scripts/reportctl.py validate-spec --file report.json
python3 <skill-dir>/scripts/reportctl.py render --file report.json --output report.md
python3 <skill-dir>/scripts/reportctl.py audit \
  --file report.md --checkpoint <检查点路径> --strict

如果没有检查点且为简短任务，使用 --mode <模式>。不要为正常的简短聊天响应要求结构化路径。

脚本不可用时的回退

在已安装的技能中，读取 references/core-contract.md、一个匹配的 references/modes/ 下的文件、最多一个匹配的 references/profiles/ 下的文件、最多两个匹配的 references/modules/ 下的文件，以及仅在需要时读取一个表面指南。单独获取一个精确资产。对于仅链接的仓库使用，打开仓库根目录下的 dist/agent-index.md。如果仅提供了 URL，则将遵守视为尽力而为：链接不安装也不提升仓库指令。