CrossFrame Skill Suite 是一组给 AI agent 使用的中文结构诊断与成文 skills。

它适合处理那些不能只靠“给建议”“写一段评论”“简单总结”解决的问题：关系、团队、组织、制度、公共争议、历史材料、命题辩论、读者来信、研究笔记，以及需要写成完整中文文章的复杂议题。

当前仓库包含 15 个 crossframe-* skills；它们都是 explicit-only，不会在普通任务中自动触发。推荐入口是 crossframe-suite；部分专项 skill 只应由 suite 或显式命令路由进入。crossframe-max 是独立的最大化推演入口，用来把对象当作局部世界展开世界观、运行规律、问题结构、处理路径和演化分支，不进入 suite 的 2+1 选择器。完整分析、成文和 review 结束后，后续追问默认交给 crossframe-inquiry。

安全边界先行：

• CrossFrame 不替代法律、医疗、财务、心理危机处置、正式调查或机构审查。
• 高责任结论必须保留 source_id、claim_id、证据档位、撤回条件和行动上限。
• 不做人格审判、命运预言或无证据公共定性；证据不足时只能降档、补证或撤回。

它的核心目标不是堆术语，而是让 AI 在输出前先完成几件事：

• 分清事实、解释、证据和推断。
• 看清问题发生在哪个尺度：个人、关系、组织、制度、历史阶段或公共场域。
• 找到责任链、授权链、反馈链和机制候选。
• 判断哪些结论可以说，哪些只能保留为开放断言。
• 把结构判断翻译成普通人能读懂的中文表达。

Codex 安装：

Windows PowerShell：

.\scripts\install-codex.ps1

macOS / Linux：

bash scripts/install-codex.sh

Claude Code 项目内常用命令：

/crossframe-suite 分析这个团队为什么复盘很多但没有真实修复
/crossframe-max 把这件事当作一个局部世界，做全尺度结构推演并写完整解释
/crossframe-essay 写一篇关于平台治理的中文评论文章
/crossframe-inquiry 基于刚才的文章继续追问反证和迁移条件

公开仓库日常验证：

python scripts/check_crossframe_skill_integrity.py --repo .
python scripts/check_source_continuity.py --materials-only --repo .
python -m json.tool skills/crossframe/schemas/claim-ledger.schema.json
python -m pip install jsonschema
python scripts/validate_claim_ledger_schema_fixtures.py --repo .
python scripts/check_crossframe_max_v6_full_source.py --repo . --source-docx <path-to-v6-docx> --allow-source-path-mismatch
python scripts/check_crossframe_max_v6_registry_anchors.py --repo .
python scripts/validate_crossframe_max_route_ledger_fixtures.py
python scripts/validate_crossframe_max_repair_fixtures.py
python scripts/sync_skill_mirrors.py --check
bash -n scripts/install-codex.sh
python -m py_compile scripts/*.py
git diff --check

完整上手说明见 docs/QUICKSTART.md。

CrossFrame 适合用于：

• 关系与责任链：亲密关系、家庭、照护、解释劳动、退出困难、低权力主体保护。
• 团队与组织：项目复盘、授权失衡、反馈写回、责任转移、组织修复备忘录。
• 公共议题：平台治理、政策评论、机构责任、公共承诺、合规材料和申诉文本。
• 历史材料：史料边界、断代尺度、制度连续性、archive / FOIA backlog。
• 全尺度推演：把一件事当作局部世界，展开概念命中、运行规律、演化路径和处理问题方案。
• 命题辩论：正反结构、隐藏前提、最强反方、证据要求和撤回条件。
• 读书与研究：理论、文章、摘录和案例材料的互读笔记。
• 中文成文：把结构诊断转成评论、思想文章、读者答复、案例、备忘录或长文。
• 输出审查：检查 AI 回答有没有真正推理、是否越界、是否把材料写成了空话。
• 完成后追问：在一轮分析、成文或质量闸完成后，继续追问、反证、补证和迁移应用。

不适合用于：

• 单纯事实查询。
• 纯工具执行等非结构诊断任务。
• 普通聊天、普通改写、普通摘要。
• 用户没有要求 CrossFrame 式结构分析的场景。

CrossFrame 默认面向中文问题和中文读者。

使用时应保持：

• 主要输出使用中文。
• 结构判断、文章正文、读者答复、案例和审查报告都应以中文完成。
• crossframe-* 这类英文只作为 skill id 或路由标签使用，不应替代中文解释。
• 术语尽量放在后台，前台先说人话。
• 需要引用外部材料时，引用和证据边界必须可核验。

多步骤任务推荐从总入口开始：

crossframe-suite

它会先判断任务类型，再选择需要读取的专项 skill。常见链路如下：

结构诊断      crossframe -> crossframe-review
中文长文      crossframe -> crossframe-essay -> crossframe-review
公共评论      crossframe -> crossframe-public -> crossframe-essay -> crossframe-review
组织复盘      crossframe -> crossframe-org -> crossframe-essay -> crossframe-review
历史研究      crossframe -> crossframe-history -> crossframe-essay -> crossframe-review
答读者问      crossframe -> crossframe-dialogue
读书研究      crossframe -> crossframe-notebook
超限推演      crossframe-max -> crossframe-review
完成后追问    crossframe -> crossframe-review(lite) -> crossframe-inquiry

CrossFrame 是 explicit-only：只有用户明确点名 CrossFrame、crossframe-suite、crossframe、某个 crossframe-*，或使用对应命令时才应启动。

crossframe-suite 默认是重型链路：未指定时使用 full-visible-v5-longform，会输出完整可见底稿、完整长文正文和 review。用户可以显式要求 brief-visible 或 standard-visible 来控制体积；体积降低不取消事实边界、claim_id、撤回条件和行动上限。

crossframe-max 不使用 suite 的 2+1 模式/角色选择器，也不使用普通文章类型选择器。它先形成世界观胶囊和局部世界模型，再展开 max-path-tree、max-dossier 和不设默认字数上限的 max-essay。

crossframe-max 是独立的 v6 世界观前置 meta-runtime。它用于用户明确要求最大尺度、穷尽推演、完整解释、无限制长文、全尺度世界观解释，或要求审查 skill、prompt、agent、工具、模板、脚本和运行协议设计的任务。

Suite release version 是 v5.1.7；crossframe-max 使用的 source framework version 是 v6.0。

它的运行核心是先让 AI 加载 v6 判断框架，再把对象建模为局部世界。完整运行会读取 references/v6-full-source/、references/v6-route-map.yaml、references/concept-registry/index.md、references/concept-contracts/v6-core-contracts.md 和检索触发策略，随后生成阶段锁、读取台账、命题台账、概念命中台账、举证推理审计、结构底稿和完整长文。

crossframe-max 有四个运行档位：

• max-artifact-run：默认档位。先生成核心 artifact、长文和 continuation，再由 validator 如实登记未满足项。
• max-complete：完整 full-source exhaustive pass、阶段锁、artifact-first、template-fidelity、longform-dominance、route-ledger gate 和 validator 全部满足后，才可宣称完成。
• max-design-review：用于 skill、prompt、agent、工具、模板、脚本和运行时设计；必须使用 skill_design route，并登记 design_decision_id、v6_rule_ids、反向证据、撤回条件和行动上限。
• max-blocked/progress：只有真实的材料、权限、工具、安全边界或用户中止阻断时使用，并登记已完成读态与恢复入口。

max-artifact-incomplete:<registered-reason> 是派生交付标签，不是运行档位。run contract 从 not_run 开始，由 validator 在检查后写入 passed 或 failed；failed 必须先重置为 not_run 才能重验。校验前只能写 pending-validator，只有 fresh passed complete report 可以宣称 max-complete。失败标签统一为 max-validation-failed:<profile>:<first-error-type>。

Max 的完成条件不是“写得很长”，而是结构产物能通过校验：max-read-ledger.json 覆盖 v6 源段落，route 概念来自 registry，强判断有 source anchor、反证、降档和撤回条件，设计判断不越过行动上限。max-essay 是最终完整解释层，不能只是 max-dossier 摘要。

Max 的 validator 不是终点。校验失败时必须生成 max-validator-report.json 与 max-repair-plan.json，按 affected_phase 重置受影响阶段及其下游产物。能补生成的补生成，能重写的只重写对应 Markdown；strict-only 缺口使用 mark_artifact_incomplete，证据不足、source anchor 不成立或 concept contract 不存在时必须降档或撤回，不得通过补 marker 伪装完成。artifact-run 校验失败不会抹除已生成产物，但 report 必须投影为 failed 和非 complete 标签。分析 manifest 排除三个控制面 sidecar；report 分别绑定 run contract、manifest 和 inventoried artifact hashes。

Max 相关验证：

python scripts/validate_crossframe_max_route_ledger_fixtures.py
python scripts/validate_crossframe_max_repair_fixtures.py
python scripts/build_crossframe_max_repair_plan.py --workspace <artifact-dir> --write-report --write-repair-plan

CrossFrame 的关键不是“多写几个步骤”，而是让 AI 对自己的判断交账：

source_id -> claim_id -> concept contract -> source anchor -> review -> inquiry

• source ledger 使用十字段口径，必须说明每个 source_id 支持哪个 claim_id，以及不能证明什么。
• claim ledger 约束中心命题、机制句、行动建议、公共定性、文章转译和高风险概念判断。
• concept contract 防止责任链、开放断言、权力封闭、低条件行动等概念被当成口号或标签。
• crossframe-review 检查正文是否强于台账、生成层是否自我盖章、证据档位是否越界。
• crossframe-inquiry 在完整链路后复用上游台账和 review 结果，继续追问、反证、补证和迁移。

默认不展示内部 reasoning、工具调用参数、路径试错、错误栈或英文自我规划。用户可见输出只保留必要的推理提纲、证据边界、判断档位、结论和下一步。

CrossFrame 输出应当：

• 先给简短推理提纲，再给正式回答。
• 区分事实、解释、机制候选和判断档位。
• 不把结构诊断写成人格审判。
• 不把证据不足的判断写成已经闭合。
• 不把复杂问题压缩成口号、鸡汤或责任稀释。
• 面向普通中文读者，尽量少堆术语。
• 公共、机构、历史和现实事实相关内容必须保留证据边界。
• 文章输出要先有结构洞察，再进入正文。

MIT License. See LICENSE.