Artifact 市场：Operit 的产出物模板与预设

Artifact 是什么

Artifact（制品）是 v1.11 起引入的概念——和 Skill / MCP 的「能力」不同，Artifact 是能力的产出物模板或预设工作流。可以理解为：

• MCP = 原子能力
• Skill = 组合能力（多步流程）
• Artifact = 可复用的产出物（模板、脚手架、预设）

Artifact 类型

Operit 统一市场里的 Artifact 大致分为：

项目脚手架

一键生成项目初始结构：

• Python API 项目：FastAPI + SQLAlchemy + 项目结构
• Node.js REST API：Express + TypeScript + JWT 鉴权
• Go CLI 工具：Cobra + Viper + 项目布局
• 静态网站：Hugo / MkDocs / 纯 HTML 模板

文档模板

让 Agent 生成标准化文档：

• 技术博客模板：标题层级、代码块位置、图片占位
• PRD 模板：产品需求文档标准章节
• README 生成器：读 Git 仓库结构自动生成项目 README
• API 文档：OpenAPI / Swagger 格式自动生成

代码片段库

常用函数、正则、SQL 查询的预存集合：

• Python 数据处理：pandas / numpy 常用操作
• SQL 查询：多表 JOIN / 聚合 / 窗口函数模板
• 正则表达式：邮箱、手机号、URL、日期匹配
• Shell 脚本：常见运维脚本模板

预设工作流

开箱即用的多步自动化：

• 内容流水线：搜索 → 整理 → 绘图 → TTS → 归档
• 代码提交检查：Git diff → 自动审查 → 生成 commit message
• 邮件摘要：定时读邮件 → 生成摘要 → 写 Notion

使用流程

方式一：让 Agent 生成

> 「用 Artifact 模板帮我创建一个 FastAPI 项目」

Agent 匹配到对应 Artifact → 在指定目录生成项目结构 → 返回目录路径和启动命令。

方式二：手动浏览市场

1. 打开统一市场 → Artifact 分类
2. 浏览分类或搜索
3. 点选 → 查看模板详情
4. 选择输出目录 → 一键生成

方式三：和 Skill 配合

Artifact 可以被 Skill 引用——比如「深度检索」Skill 自动用「Markdown 大纲」Artifact 作为输出格式：

> 「深度检索 2026 年 Agent 框架对比，整理成报告」
  → Skill 执行检索
  → 用「技术博客」Artifact 模板输出
  → 自动生成规范的报告文档结构

Artifact 和工作流的区别

自己写 Artifact

Artifact 结构很简单：

my-artifact/
  artifact.json        # 元数据
  template/            # 模板文件（支持占位符 {{变量名}}）
  variables.json       # 可选的变量定义

写完后放到统一市场目录或社区，就能被其他 Operit 用户使用。

常见问题

生成的模板占位符没填

Artifact 里的 {{项目名}} 等占位符需要 Agent 从上下文推断。如果没推断出来，在对话里补一句：

「项目名叫 my-awesome-api，Python 3.12」

生成位置不对

默认生成到当前对话上下文指定的目录（或 Operit 内部存储）。可以在指令里明确：

「生成到 ~/projects/myapi/ 目录下」