ARA-Labs/Agent-Native-Research-Artifact

ARA‑Labs / Agent‑Native‑Research‑Artifact

是什么

• 一个轻量级、开源的工具包，让AI驱动的“研究代理”能够以结构化、可验证的格式记录实验的每一步。它定义了一种文件系统布局（即 ARA 资产），将主张、代码、配置、原始结果和可搜索的探索图整合在一起。

为何重要

• 当代理自主运行时，会留下混乱的覆盖脚本和终端日志。ARA 强制代理 守卫输出，将混乱的轨迹 结晶化 为可复用的知识，并通过简洁的可视化提供 全面可观测性。这使得研究可复现、可审计、可扩展，而无需手动拼接笔记本、PDF 和仓库。

核心设计原则

1. 守卫与验证 – 每个主张都与具体的执行资产绑定，可被形式化检查。
2. 结晶化洞察 – 系统捕获转折点、死胡同和推理过程，将其转化为一等节点。
3. 全面可观测性 – 生成的 HTML 过程图让人类监督者无需阅读原始终端输出即可看到整个 DAG。

工具包 – 七个“代理技能”

技能	功能	如何调用
research‑manager	在工作时自动捕获决策、配置、消融实验	/research‑manager（或自动运行）
compiler	将现有论文/仓库/笔记转换为完整的 ARA 资产	/compiler <path>
rigor‑reviewer	运行形式化检查，确保每个主张都有执行支持	/rigor‑reviewer <dir>
research‑visualizer	生成探索 DAG 的交互式 HTML 地图（或提供实时视图）	`/research‑visualizer <ara‑dir> [--serve
research‑foresight	回答“我接下来该尝试什么？”并提供有依据、可证伪的建议	/research‑foresight <ara‑dir> "<question>"
context‑drop	通过单个 URL 与另一个代理共享文件/文件夹（无需仓库）	/context‑drop <path>
research‑fuzzer	将调查视为模糊测试：预测下一步动作，标记循环，结论前要求自我反驳	/research‑fuzzer

所有技能可通过一行命令安装，该命令读取 wire-ara.md 并为所用代理（Claude Code、Cursor、Gemini CLI、Codex 等）注册相应命令。也可通过 npx @ara-commons/ara-skills 手动安装。

资产结构（文件布局）

example_artifact/
  PAPER.md                # 短暂的清单（~200 词元）——高层次的相关性
  logic/                  # *认知* 层 —— 主张、实验计划、设计
    claims.md
    experiments.md
    solution/            # 架构、算法、约束
  src/                    # *物理* 层 —— 代码、配置、环境
  trace/                  # *探索* 图 —— 尝试、死胡同的 DAG
  evidence/               # 原始表格、图表、提取数据

跨层绑定将每个主张与支持它的精确实验、代码和证据关联；失败的尝试作为一等节点保留，确保代理不会重复相同的死胡同。

如何开始

1. 从项目根目录粘贴 README 中显示的一行命令。代理获取 wire-ara.md，安装七个技能，并将其路由图写入自身上下文文件（如 CLAUDE.md）。
2. 工作过程中，research‑manager 技能会自动记录每个决策。
3. 准备就绪后，运行 research‑visualizer --serve 检查完整 DAG，或运行 rigor‑reviewer 在发布前认证资产。

兼容性

• 实现了 代理技能 开放标准，因此可与任何支持该规范的 LLM 驱动的编码助手（Claude Code、Cursor、Gemini CLI、OpenAI Codex、GitHub Copilot 等）兼容。

成熟度与社区

• 仓库包含 CLI（ara‑skills）、演示仓库（ARA‑Demo）和完整示例资产（examples/the-ara-of-ara）。
• 配有同行评审的 arXiv 论文（arXiv:2604.24658），将该方法与 PDF + 仓库基线进行基准测试。
• MIT 许可，提供 CONTRIBUTING 指南以添加新技能。

何时使用

• 如果你正在运行自主研究代理（例如用于 ML 模型设计、数据管道发现或科学模拟），并需要一个可复现、可审计的过程记录。
• 当你希望有一个单一、便携的表示形式，可作为会议提交、共享研究资产或下游代理的起点时。

---

引用

@misc{liu2026humanwrittenpaperagentnativeresearch,
  title={The Last Human-Written Paper: Agent-Native Research Artifacts},
  author={Jiachen Liu and Jiaxin Pei and Jintao Huang and …},
  year={2026},
  eprint={2604.24658},
  archivePrefix={arXiv},
  primaryClass={cs.LG},
  url={https://arxiv.org/abs/2604.24658}
}