Imported from xi-kari/crossframe-skill (
AGENTS.md). Install upstream withnpx skills add xi-kari/crossframe-skill. Copyright stays with the author.
CrossFrame / Agent Adapter
本文件是给通用 AI agent 的仓库级入口说明。仓库主体仍以 README.md、skills/crossframe-suite/SKILL.md、skills/crossframe/SKILL.md、skills/crossframe-essay/SKILL.md 与 skills/crossframe-critical/SKILL.md 为准。
仓库怎么理解
skills/crossframe-suite/：CrossFrame skill family 总调度入口，负责连续触发顺序和质量闸。skills/crossframe/：真正可安装的 Codex skill 主体。skills/crossframe-essay/：平行文章写作 skill，把 CrossFrame 结构判断转成中文批判性洞察文章。skills/crossframe-critical/：点名调用的结构批判长文 skill，输出批判底稿、篇章方案和完整正文；不接入 suite 默认调度。skills/crossframe-review/：评审 CrossFrame 输出是否真推理、守证据和边界。skills/crossframe-dialogue/：答读者问、编辑回信和咨询式短答复。skills/crossframe-casebook/：把材料整理成可复用案例库。skills/crossframe-history/：历史材料、史料闭合、文明连续史和 archive/FOIA backlog 领域接口层。skills/crossframe-inquiry/：已完成 CrossFrame 流程后的结构追问层。skills/crossframe-max/：显式点名的最大化结构推演入口，把一件事当作局部世界展开世界观、运行规律、问题结构、处理路径和演化分支；不走 suite 的2+1选择器。skills/crossframe-promax/：只接受精确名称的 v8 独立推演入口，内置生成、反证、校验和修复闭环。skills/crossframe-public/：公共议题、平台申诉、制度评论和合规材料专项。skills/crossframe-org/：团队、项目、组织修复专项。skills/crossframe-teach/：CrossFrame 概念教学解释专项。skills/crossframe-debate/：命题辩论与论证检验专项。skills/crossframe-notebook/：读书、理论和文章研究笔记专项。skills/crossframe/protocols/：诊断、推演、开放断言、反俘获、低条件行动协议。skills/crossframe/worksheets/：intake、五闸、证据账本、机制候选等推理发动机。skills/crossframe/references/read-routing-map.md：按请求类型决定要读哪些协议、工作表、概念卡和模板。skills/crossframe/references/v5-term-fidelity.md：v5.0 术语保真层，防止压缩后概念失真。skills/crossframe/references/v5-source-spine.md：v5.0 DOCX 源结构脊柱，记录章节顺序、相邻关系和承接状态。skills/crossframe/references/v5-section-digest-index.md：逐节保真摘要索引，防止读少或断章。skills/crossframe/references/runtime-read-policy.md：运行时读取成本与材料层级，避免把维护档当作必读正文。skills/crossframe/references/continuity-closure-map.md：轻量连续性闭包图，确认高风险概念需要同读哪些材料。skills/crossframe/references/continuity-bundles.md：连续联读包历史详参，规定哪些概念不能只读单卡。skills/crossframe/references/theory-backend-index.md：长期演化、根假设、阶段、递进、多中心治理等深水区索引。skills/crossframe/references/v5-coverage-map.md：v5.0 重要模块到 skill 文件的覆盖地图，维护时用于查漏。skills/crossframe/templates/：用户可见输出模板，默认包含推理提纲。- 适配层：
CLAUDE.md、.claude/skills/crossframe*/SKILL.md、.claude/commands/crossframe*.md、GEMINI.md、.cursor/rules/crossframe*.mdc、.github/copilot-instructions.md、.windsurf/rules/crossframe.md、.clinerules/crossframe.md、.roo/rules/crossframe.md、.continue/rules/crossframe.md、CONVENTIONS.md、.aider.conf.yml、llms.txt。
显式调用边界
整套 CrossFrame skill 不能被动触发。只有当用户明确点名 crossframe-suite、crossframe、某个 crossframe-*，使用 $crossframe-* / /crossframe-*，或明确说“用 CrossFrame / 用跨尺度结构诊断框架”时，才进入本仓库的 CrossFrame 链路。
这条限制只约束外部初始触发，不禁止 suite 内部联合调用。用户显式调用 crossframe-suite 后，suite 仍然可以按 workflow-routing-map.md 读取和串联 crossframe、crossframe-essay、crossframe-review 及其它 sibling skill。
只要用户从 crossframe-suite 总入口进入 CrossFrame 内容任务，默认最终输出 full-visible-v5-longform：先完成必要专项 skill，再追加 crossframe-essay -> crossframe-review，包含完整可见底稿和完整长文正文。只有用户明确说“只要/不要文章/短答/表格/清单/纯诊断/仅行动方案”时，才关闭默认文章层。
crossframe-max 是独立模式：只有用户明确点名 crossframe-max、/crossframe-max、$crossframe-max，或明确要求最大算力、全尺度穷尽推演、不设字数限制完整解释时才读取。它不走 crossframe-suite 的 2+1 模式/角色选择器，也不走普通文章类型选择器。
CrossFrame ProMax 是 v8-only 的 exact-name only 独立 skill：仅在用户精确点名 crossframe-promax、CrossFrame ProMax、$crossframe-promax 或 /crossframe-promax 时读取 skills/crossframe-promax/SKILL.md。Max 与 ProMax 同时出现时 ProMax 优先；泛化最大化请求仍由 Max；suite 不得自动升级；ProMax 使用独立审计，不串联 review，也不得降级回 Max。
显式调用后，按任务内容路由到以下能力：
crossframe-critical 是更严格的 named-only 平行 skill：它不得加入 crossframe-suite 默认链路或总调用适配。只有用户明确写 $crossframe-critical、crossframe-critical 或要求测试批判 skill 时才读取。
- 关系、团队、项目、组织、制度、公共争议中的复杂失衡
- 需要结构诊断、推演、路径展开、后续走向或分支终点
- 需要开放断言，而不是强行给终局判断
- 证据不足但风险紧急，需要低条件试探行动
- 高权力密度、高责任场景，需要反俘获审查
- 强判断、高反身性对象、亲密关系、疗愈转移、公共制度、框架边界、生命周期、递进、势场/自主解离、治理连续性、超大规模压力测试或长期演化问题
- 哲学、意义、生命第一因、虚无主义等抽象问题，需要先做概念解释、尺度拆分和结构性开放断言
- 用户希望分析复杂反复问题，但不要概念堆砌
不要用于：
- 单纯事实查询
- 代码实现、算术、工具操作等非结构诊断任务
- 医疗、法律、金融等需要专业资质的最终判断
- 用户只是需要安慰，不需要诊断分析的对话
显式调用 CrossFrame Essay
只有用户明确点名 crossframe-essay 或 CrossFrame Essay 时，才直接进入 skills/crossframe-essay/SKILL.md。若用户显式调用 crossframe-suite，且写作任务还涉及公共事实、组织修复、命题辩论、读书研究、案例沉淀或最后评审，先由 suite 决定链路；不要直接只触发 essay。
显式调用后，当任务涉及以下内容时使用 skills/crossframe-essay/SKILL.md：
- 用户要求写中文文章、长文、评论、思想文章、批判性洞察文章或结构洞察文章
- 用户想把 CrossFrame 分析结果转成普通读者能读的文章
- 用户希望文章上升概念、引经据典、加入理论参照、历史经验或文学互文
- 用户希望文章像一位现代编辑同志耐心、谦逊、认真、果敢地回应读者问题
- 用户给出零散素材，希望整理成有中心命题、有递进、有边界的长文
- 主题是关系、团队、组织、制度、公共议题或哲学概念，但目标是“成文”而不是只要诊断
CrossFrame Essay 仍然必须读取 skills/crossframe/SKILL.md 与 skills/crossframe/references/read-routing-map.md。默认输出顺序是完整可见 结构洞察底稿 -> 完整长文 文章正文。
如果启用概念上升，先从结构机制抽象上位概念，再选择中西经典、历史经验、理论或文学互文，最后回落到现实责任链。直接引用必须可核验；不确定原句时只做意译或思想映射。
自动成文默认启用 full-visible-v5-longform 和现代编辑底色，先在底稿中写出 正文声口方案，再成文。问题型主题用答复体，公共评论、思想文章和概念文章用评论体。只有用户明确要求短答、中性报告、备忘录、表格、清单、纯诊断或学术摘要时才关闭；不要复古口号化，不要把亲切写成和稀泥，也不要把严厉写成人格审判。
显式调用其它平行 skill
- 审查、评审、打分、抓坏输出、判断是否真的推理；用户明确点名
crossframe-review：skills/crossframe-review/SKILL.md - 点名结构批判长文、要求批判底稿 + 篇章方案 + 1800-2800 字正文；用户明确点名
crossframe-critical：skills/crossframe-critical/SKILL.md - 答读者问、编辑回信、咨询式短答复、我该怎么看/怎么办：
skills/crossframe-dialogue/SKILL.md - 整理聊天记录、组织材料、项目复盘、公共争议为案例库：
skills/crossframe-casebook/SKILL.md - 历史材料、历史事件、史料互读、长时段演化、archive/FOIA backlog：
skills/crossframe-history/SKILL.md - 完成态后继续追问、反证、补证、迁移应用或行动边界确认：
skills/crossframe-inquiry/SKILL.md - 最大化结构推演、局部世界建模、全尺度解释、演化路径穷尽：
skills/crossframe-max/SKILL.md - 精确点名的 v8 ProMax 穷尽推演、全概念命中、自反例攻击：
skills/crossframe-promax/SKILL.md - 公共议题、平台申诉、制度评论、机构合规材料、公共承诺兑现：
skills/crossframe-public/SKILL.md - 团队、项目、组织修复、复盘改造、反馈写回、低风险试点：
skills/crossframe-org/SKILL.md - CrossFrame 概念教学、误读纠偏、现实信号、练习题：
skills/crossframe-teach/SKILL.md - 命题、争论、正反双方、隐藏前提、证据要求、撤回条件：
skills/crossframe-debate/SKILL.md - 读书、理论、文章、摘录研究笔记，比较关联与不同：
skills/crossframe-notebook/SKILL.md
这些平行 skill 都必须保持轻入口：先读取各自 SKILL.md，再按其说明读取 skills/crossframe/SKILL.md 和 skills/crossframe/references/read-routing-map.md；不得复制 CrossFrame 全文。
连续触发规则
默认链路：
- 结构诊断：
crossframe -> crossframe-essay(full-visible-v5-longform) -> crossframe-review - 普通洞察文章：
crossframe -> crossframe-essay -> crossframe-review - 公共评论文章：
crossframe -> crossframe-public -> crossframe-essay -> crossframe-review - 组织复盘/修复文章：
crossframe -> crossframe-org -> crossframe-essay -> crossframe-review - 答读者问：
crossframe -> crossframe-dialogue -> crossframe-essay(full-visible-v5-longform) -> crossframe-review - 案例沉淀：
crossframe -> crossframe-casebook -> crossframe-essay(full-visible-v5-longform) -> crossframe-review - 历史研究：
crossframe -> crossframe-history -> crossframe-essay(full-visible-v5-longform) -> crossframe-review - 最大化推演：
crossframe-max -> crossframe-review - v8 ProMax：
crossframe-promax（独立审计，不串联 review） - 概念教学：
crossframe -> crossframe-teach -> crossframe-essay(full-visible-v5-longform) -> crossframe-review - 命题辩论：
crossframe -> crossframe-debate -> crossframe-essay(full-visible-v5-longform) -> crossframe-review - 读书研究：
crossframe -> crossframe-notebook -> crossframe-essay(full-visible-v5-longform) -> crossframe-review - 读书后成文：
crossframe -> crossframe-notebook -> crossframe-essay -> crossframe-review - 完成后追问：
crossframe -> crossframe-review(lite) -> crossframe-inquiry
连续触发只发生在用户显式调用 crossframe-suite 之后。此时先给短 调度提纲：任务类型、工作流、必读 skill、按需读取、不读取、质量闸。不要为了完整而读取全部 skill。
总入口默认对任何 CrossFrame 内容任务成文，并默认是 full-visible-v5-longform；显式关闭文章层时才保留原形态。
完整链路已经完成分析、成文和 review 后，下一轮实质输入默认进入 crossframe-inquiry；纯致谢、确认收到或结束语（如“谢谢”“好的”“明白了”“先这样”）只轻量收束，不自动展开追问。
必须遵守
- 中文为权威语义，英文只作传播名或文件名。
- 先形成内部推理产物，再输出结论。
- 默认先展示简短推理提纲：
- 诊断对象
- 事实边界
- 尺度窗口
- 机制候选
- 判断档位
- 本次读取的概念
- 下一步
- 先说人话，再按需补术语映射。
- 至少列两个机制候选，除非证据足以排除其他可能。
- 不把结构诊断变成人格审判、宿命判断或责任稀释。
- 开放断言必须包含证据、替代解释、撤回条件和行动边界。
- 如果使用承接/回流、开放断言、尺度转移、观测反身性、权力封闭、低条件试探行动、爱/开放行动、主体/责任链、证据成本、机制候选、判断档位、退出转移、修复副产品等高风险概念，先读取
skills/crossframe/references/concept-cards/README.md与对应概念卡。 - 输出前用
skills/crossframe/references/runtime-read-policy.md、skills/crossframe/references/read-routing-map.md和skills/crossframe/references/continuity-closure-map.md做轻量闭包检查，确认概念卡、联读包、现实行为和降档条件没有漏掉。 9.1 需要审计或展开细节时，再按需查看skills/crossframe/worksheets/concept-fidelity-check.md与skills/crossframe/worksheets/source-continuity-check.md；高责任、公共制度、亲密关系、长期演化、深度分析和文章输出不能只读单张概念卡。 - 强判断必须走命题验证；高反身性对象必须有限收束；亲密关系先保护痛苦、安全和边界；疗愈转移不替代专业干预。
- 框架边界问题不得把 CrossFrame 当专业替代品；生命周期不得写成命运；超大规模判断必须写不可判断区。
- 哲学/意义类问题不要机械退回“不可诊断”；先尝试结构化解释，只有无法结构化时才退回框架边界。
- 默认不展示内部 reasoning、工具调用参数、路径试错、错误栈或英文自我规划；用户可见输出只保留必要的推理提纲、证据边界、判断档位、结论和下一步。
读取优先级
- 复杂多交付任务先读 skills/crossframe-suite/SKILL.md 与
skills/crossframe-suite/references/workflow-routing-map.md - skills/crossframe/SKILL.md
- 先读取
skills/crossframe/references/read-routing-map.md确定本次路由 2.1 需要连续保真时读取skills/crossframe/references/runtime-read-policy.md和skills/crossframe/references/continuity-closure-map.md；需要追踪原文相邻结构时，再读取skills/crossframe/references/continuity-bundles.md、skills/crossframe/references/v5-source-spine.md、skills/crossframe/references/v5-section-digest-index.md与skills/crossframe/worksheets/source-continuity-check.md - 普通诊断读取
skills/crossframe/protocols/diagnosis-protocol.md - 推演读取
skills/crossframe/protocols/inference-protocol.md - 开放断言读取
skills/crossframe/protocols/open-assertion-protocol.md - 高责任场景读取
skills/crossframe/protocols/anti-capture-protocol.md - 证据不足但紧急读取
skills/crossframe/protocols/low-condition-action-protocol.md - 概念解释读取
skills/crossframe/protocols/concept-explanation-protocol.md - 强判断读取
skills/crossframe/protocols/proposition-verification-protocol.md - 高反身性读取
skills/crossframe/protocols/high-reflexivity-protocol.md - 亲密关系读取
skills/crossframe/protocols/intimate-relationship-protocol.md - 疗愈转移读取
skills/crossframe/protocols/healing-transfer-protocol.md - 公共制度读取
skills/crossframe/protocols/public-institution-protocol.md - 历史领域接口读取
skills/crossframe-history/SKILL.md - 完成态追问读取
skills/crossframe-inquiry/SKILL.md - 框架边界读取
skills/crossframe/protocols/framework-boundary-protocol.md - 生命周期读取
skills/crossframe/protocols/lifecycle-diagnosis-protocol.md - 递进闭环读取
skills/crossframe/protocols/progression-protocol.md - 势场与自主解离读取
skills/crossframe/protocols/field-dissociation-protocol.md - 治理连续性读取
skills/crossframe/protocols/governance-continuity-protocol.md - 超大规模压力测试读取
skills/crossframe/protocols/large-scale-stress-test-protocol.md - 对外表达翻译读取
skills/crossframe/protocols/expression-translation-protocol.md - 长期演化或理论深水区读取
skills/crossframe/references/theory-backend-index.md - 输出前读取
skills/crossframe/templates/reasoning-outline-output.md与对应输出模板 - 高风险概念读取
skills/crossframe/references/concept-cards/下的对应卡片
文章写作额外读取：
skills/crossframe-essay/SKILL.mdskills/crossframe-essay/protocols/essay-protocol.md或interactive-drafting-protocol.mdskills/crossframe-essay/references/evidence-and-search-rules.mdskills/crossframe-essay/references/critical-insight-principles.md- 概念上升读取
skills/crossframe-essay/protocols/concept-elevation-protocol.md、references/reference-and-allusion-rules.md、references/concept-reference-map.md - 自动成文默认读取
skills/crossframe-essay/protocols/editorial-comrade-voice-protocol.md与references/editorial-voice-principles.md；显式中性报告/备忘录/表格/纯诊断时才关闭 skills/crossframe-essay/templates/insight-dossier-template.mdskills/crossframe-essay/templates/essay-output-template.md或interactive-session-template.md
平行专项 skill 读取：
- 先读对应
skills/crossframe-*/SKILL.md - 再读
skills/crossframe/SKILL.md与skills/crossframe/references/read-routing-map.md - 按专项
protocols/、references/、templates/输出 - 需要成文时才按需读
skills/crossframe-essay/SKILL.md
修改仓库时
- 不要把
skills/crossframe/的可安装入口改丢。 - 不要把薄适配层扩写成另一份完整正文。
- 适配层必须保持薄入口：说明触发条件、读取顺序、输出闸，不复制完整协议。
- 新增概念前先确认它是否能进入工作表、闸门或模板，否则不要升格。
- 防失真材料优先放在
references/和概念卡中，不要把 v5.0 全文塞回SKILL.md。 - 新增或补齐 v5.0 概念时，同步更新
skills/crossframe/references/v5-coverage-map.md。 - 新增文章写作规则时，优先更新
skills/crossframe-essay/，不要把文章协议复制到根适配层。 - 改完后运行 skill 验证，并确认本地安装目录需要同步时已同步。
