mcpField
A
artifacts

artifacts

github.com/allenai文档处理4254 次安装2 天前更新
代码仓库

关于 artifacts

这项命令行技能可将 A2A Agent 任务结果中的结构化产物导出为 Markdown 或独立 HTML，并按产物子类型整理文件，附带索引和元数据，便于阅读、分享、版本控制或索引。

主要功能

  1. 01将任务产物导出为 Markdown 或 HTML
  2. 02按产物子类型整理文件
  3. 03生成索引、参考文献和清单
  4. 04导出部分任务数据用于预览
  5. 05将导出文件登记到 asta-documents

适用场景

  1. 01将 A2A 任务结果转换为易读文件
  2. 02在任务运行期间预览产物
  3. 03分享独立 HTML 导出文件
  4. 04为后续搜索建立产物索引

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/allenai/asta-plugins --skill artifacts

安装后在 Claude Code 中输入/artifacts确认已加载。

详细介绍

Asta Artifacts

Artifacts 是 A2A Agent 生成的结构化输出。它们会累积在任务响应的 artifacts[] 字段中。

导出

# 1. Dump task result
TASK_DIR=$(mktemp -d)
asta <agent> task "<TASK_ID>" > "$TASK_DIR/task.json"

# 2. Export (caller decides output dir and format)
asta artifacts --input "$TASK_DIR" --output "$OUT_DIR" --format md

按子类型整理生成的文件，并附带 index.md、references.bib 和 manifest.json。

也适用于不完整的任务数据，可用于在运行过程中预览。

格式

  • --format md — Markdown 格式，每个 Artifact 对应一个 .md 文件。Artifact 之间的链接使用相对 .md 路径。最适合大模型处理、版本控制以及索引到 asta-documents。
  • --format html — 自包含 HTML，包含 index.html。使用 open "$OUT_DIR/index.html" 打开。最适合阅读或分享。

路径约定（由其他技能调用时）

其他技能将运行任务交由此技能导出时，默认写入以下路径：

.asta/<invoking-skill>/<slug>/

其中 <slug> 格式为 YYYY-MM-DD-<short-query-slug>：日期在前以便按时间顺序排列，短 slug 根据主要输入（查询、主题等）生成。使用 asta-documents 将导出的 Artifact 注册到 .asta/<invoking-skill>/index.yaml 中的单个技能聚合索引，以便使用者搜索所有运行结果。

示例（theorizer 运行）：

.asta/generate-theories/2026-04-17-media-polarization/   # per-run outputs
.asta/generate-theories/index.yaml                        # aggregate index

使用 asta-documents 建立索引

导出后，读取 manifest.json，并使用 asta documents add 注册每个条目。每个 manifest 条目包含：name、description、filename、mime_type，以及可选的 subtype 和 metadata。将这些字段直接映射为：

  • file://<absolute-path-to-OUT_DIR>/<filename> 作为 URL
  • --name 使用 name
  • --summary 使用 description（若没有则使用 name）
  • --mime-type 使用 mime_type
  • 若存在 subtype，则将其用于 --tags
  • 若存在 metadata，则将其作为 JSON 用于 --extra

使用 --root <dir> 指定范围索引（例如按 Agent 索引），而不是默认的 .asta/documents/。

评论

支持 Markdown