huangnan29 ARS-Grok Build
这是 ARS 3.21.1 的 Grok Build 适配入口。上游内容固定在 ars/，必须先通过本文件路由，再按当前阶段读取必要文件。
一、首要规则
不要默认加载整个套件。一次只选择一个工作流，先完整读取对应的 WORKFLOW.md，然后只加载当前阶段需要的角色、参考资料、模板和共享契约。
内部入口使用 WORKFLOW.md；安装器注册根入口和四个Grok包装入口，不重复注册ars/内部工作流。生成交付物前读取 grok/output-contract.md，以实际过程生成披露，并遵守用户输出格式。
不得因为模型能够生成流畅内容，就把未提供、未执行或未核实的材料写成事实。文献、数据、实验、统计结果、机构政策和研究伦理结论都必须保留来源与核验状态。
二、工作流路由
| 用户意图 | 首先读取 |
|---|---|
| 深度研究、文献综述、系统综述、元分析、事实核验、研究问题收敛 | ars/deep-research/WORKFLOW.md |
| 论文规划、提纲、摘要、正文、修订、引用格式、披露、DOCX/PDF 格式指导 | ars/academic-paper/WORKFLOW.md |
| 模拟同行评审、编辑决定、方法审查、修改后复审 | ars/academic-paper-reviewer/WORKFLOW.md |
| 从研究到论文的完整分阶段流水线、完整性门和最终化 | ars/academic-pipeline/WORKFLOW.md |
| 实验规划、代码实验执行计划、人体研究方案、统计解释、可重复性检查 | ars/experiment-agent/WORKFLOW.md |
请求横跨多个工作流时，只有用户明确要求完整流水线才进入 academic-pipeline；否则先选择能够产生当前所需交付物的最小工作流。
三、模糊论文题目的前置收敛
当用户只给出宽泛主题、暂定题目或研究兴趣，却没有清晰且可回答的研究问题时，先进入 deep-research 的 socratic 模式。
- 说明当前先收敛研究问题；
- 读取
socratic_mentor_agent.md与research_question_agent.md； - 一次提出三到五个有区分度的问题；
- 在用户形成至少一个候选研究问题前，不直接生成论文提纲、正文、综述或完整流水线看板；
- 用户明确要求跳过收敛时，可以按其授权进入后续阶段，但必须记录研究范围仍可能不稳定。
四、Grok 原生命令路由
Grok 安装器会把 grok/commands/ 中的包装文件注册到 ~/.grok/commands/。收到以下命令时，读取对应的上游命令配方，再进入目标工作流：
| 命令 | 上游配方 | 目标模式 |
|---|---|---|
ars-plan |
ars/commands/ars-plan.md |
论文 plan |
ars-outline |
ars/commands/ars-outline.md |
论文 outline-only |
ars-abstract |
ars/commands/ars-abstract.md |
论文 abstract-only |
ars-lit-review |
ars/commands/ars-lit-review.md |
论文或深度研究 lit-review |
ars-3w |
ars/commands/ars-3w.md |
深度研究 three-way-scan |
ars-citation-check |
ars/commands/ars-citation-check.md |
论文 citation-check |
ars-disclosure |
ars/commands/ars-disclosure.md |
论文 disclosure |
ars-format-convert |
ars/commands/ars-format-convert.md |
论文 format-convert |
ars-revision-coach |
ars/commands/ars-revision-coach.md |
论文 revision-coach |
ars-revision |
ars/commands/ars-revision.md |
论文 revision |
ars-rebuttal-audit |
ars/commands/ars-rebuttal-audit.md |
论文 rebuttal-audit |
ars-reviewer |
ars/commands/ars-reviewer.md |
审稿 full |
ars-mark-read |
ars/commands/ars-mark-read.md |
记录用户阅读声明 |
ars-unmark-read |
ars/commands/ars-unmark-read.md |
撤销用户阅读声明 |
ars-cache-invalidate |
ars/commands/ars-cache-invalidate.md |
使一条核验缓存失效 |
ars-full |
ars/commands/ars-full.md |
完整论文流水线 |
命令后的任务仍受“模糊题目先收敛”规则约束。不得因为用户输入了命令就跳过证据、伦理、权限或强制检查点。
五、Grok Build 运行时映射
需要执行工具、子 agent、命令或 Hook 行为时，完整读取 grok/runtime-mapping.md。
普通单功能请求默认在当前会话内联执行。安装包同时提供四个命名空间化原生入口：ars-deep-research、ars-academic-paper、ars-paper-reviewer、ars-academic-pipeline；它们只负责更精确的发现和路由，上游正文仍以 ars/*/WORKFLOW.md 为唯一来源。
用户显式调用 ars-full 或 ars-academic-pipeline 时，只有当前真实工具表提供 spawn_subagent 且能解析原生类型，才可按阶段顺序调用：在完整流水线Stage 1的deep-research内部，Phase 1使用 ars-research-architect，Phase 3使用 ars-synthesis，Phase 4或Phase 6使用 ars-report-compiler。这些Phase不是完整流水线的审稿Stage 3、修订Stage 4或总结Stage 6。文件已安装不证明当前会话可调度。工具或类型缺失时明确披露并按用户允许的范围回退内联；若用户要求必须原生调用则停止。禁止用终端打印、伪造回执或父Agent代写冒充调度成功。
Grok 1.0.13复验发现：直接通过 grok --agent 启动时，工具表仍可包含 search_tool、use_tool 和已配置的MCP工具。mcpInheritance: none 是子Agent继承配置，不能宣称它保证直接启动完全隔离。不得主动使用这些额外能力；涉及私有材料时必须依据真实工具表和宿主权限单独确认，不能只相信前置白名单。
除上述三个受限阶段 Agent 外，只有用户明确要求“并行”“委派”“多 agent”“完整运行时”，才读取 grok/full-runtime-manifest.json 并启用其他 spawn_subagent 调度。Grok Build 子 agent 最大深度为一层，子 agent 不得继续创建子 agent。
多审稿席位需要独立产出各自意见，再由综合角色汇总。综合结论不得删除魔鬼代言人、方法审查或伦理审查中的关键异议。
六、网络、引用与外部传输
- 普通主题发现和资料检索使用
web_search，优先一手、官方或权威来源； - 引用存在性核验优先 DOI、出版方页面或权威元数据；
- 找不到全文时，必须区分“全文已读”“仅摘要”“仅元数据”和“无法核实”；
- 不得把 Crossref、OpenAlex、Semantic Scholar 的元数据命中写成全文核验；
- 只有用户明确要求程序化核验时，才运行上游解析器脚本；
- 跨模型 API、外部上传、付费数据库、凭证使用和敏感材料传输必须在调用前获得明确确认；
ars/scripts/cross_model_codex_transport.py仅为上游可追溯材料，不是 Grok 运行入口。
七、流水线与人工确认
分阶段工作流必须展示：当前阶段、输入、产物、核验状态、下一检查点及其强制性。
以下事项不能由模型代替用户确认：
- 研究问题和范围的最终选择；
- 作者对修订路线、研究主张或新增实验的裁决；
- 人体研究、伦理审批和机构权限；
- 外部上传、付费调用、账号操作和凭证使用；
- 对未核实风险的接受或人工阅读声明；核验状态只能由实际证据支持，用户确认不能代替核验；
- 最终投稿或对外发布。
Hook 失败采用 Grok 的 fail-open 语义，因此 Hook 只能提供提醒或机械检查，不能单独证明引用、研究伦理、数据或论文完整性已经通过。
ARS 3.21.1 默认关闭能力
- Research-workflow profile 目前只是离线、默认关闭的契约底座，没有随包提供具体研究家族配置，也没有行为有效性证据；不得自动开启、推断配置或宣称能改善研究结果。需要使用时读取
ars/shared/contracts/README.md的 profile 部分。 - Inquiry Branch Ledger 只有用户明确启用
ARS_INQUIRY_LEDGER=1时才运行。未启用时不得创建账本、摘要或提示；启用后仍必须保留作者采纳、处置、陈旧原因和项目身份边界。先读取ars/academic-pipeline/WORKFLOW.md对应章节与共享契约。 - 上游 3.21.1 对 Codex subscription citation transport 的修复只适用于其限定传输，不会在 Grok 中自动生效，也不能被解释为 Grok 跨模型复核已经验证。
八、角色文件和共享契约
工作流列出角色时：
- 读取当前工作流的
WORKFLOW.md； - 只读取当前阶段点名的
agents/*.md； - 按角色文件的输入输出契约执行；
- 阶段交接使用
ars/shared/handoff_schemas.md； - 不得凭记忆编造角色文件名。
跨工作流共享规则按需读取：
- 交接格式：
ars/shared/handoff_schemas.md； - 写作风格校准：
ars/shared/style_calibration_protocol.md； - 忠实、平衡和原创模式：
ars/shared/mode_spectrum.md； - 模型分层：
ars/shared/model_tiering.md； - 跨模型复核：
ars/shared/cross_model_verification.md； - 合规检查：
ars/shared/compliance_checkpoint_protocol.md； - 系统综述追踪：
ars/shared/prisma_trAIce_protocol.md。
上游文件中的 shared/... 解析到 ars/shared/...；根级 scripts/...、examples/... 和 docs/... 分别解析到 ars/scripts/...、ars/examples/... 和 ars/docs/...。
九、未激活的上游表面
以下内容仅为来源追踪，默认不安装、不执行：
ars/hooks/hooks.json；ars/scripts/run_codex_audit.sh；ars/scripts/cross_model_codex_transport.py；ars/pi/。
安装包提供默认关闭的 Grok PreToolUse 本地范围守卫，只有安装器显式传入 --enable-hooks 才写入；--disable-hooks 只移除本包托管配置。Hook 不联网，失败时 fail-open，也不能成为完整性证明。
十、输出默认值
- 输出语言跟随用户语言和文字习惯；
- 清楚区分证据、推断、建议与未知；
- 不生成虚构参考文献、数据、访谈、实验或统计显著性；
- 用户要求文件时，真正写入并验证文件；
- 任何强制目标未满足时，不得标记为
PASS或“可投稿”； - 最终报告只声明实际完成和实际核验过的范围。