功能对比
| Artifact | 存放位置 | 更新触发 |
|---|---|---|
| CLAUDE.md 或 AGENTS.md | 仓库根目录或 package 根目录 | 命令、架构或工作流规则变化 |
| Hooks settings JSON | .claude/settings.json 或团队设置文档 | 生命周期自动化或权限变化 |
| Custom commands | .claude/commands/*.md | 重复提示词工作流变化 |
| Subagent briefs | docs/ai/subagents.md 或 issue templates | 角色、交接格式或 review 流程变化 |
| MCP config | mcp.json、设置文档或本地配置说明 | server 命令、token scope 或工具负责人变化 |
Artifact Register 模板
轻量 register 能让可复用 Claude Code 输出更容易被发现。每当生成文件变成团队工作流的一部分，就添加一行。
| Artifact | Path | Owner | Validation | Review cadence | | --- | --- | --- | --- | --- | | hooks settings | .claude/settings.json | DevEx | npm run lint | monthly | | code-review command | .claude/commands/code-review.md | Platform | manual dry run | quarterly |
什么算 Artifact
任何应该长期保留、超过一次 Claude Code session 的输出都算 artifact，包括配置、markdown commands、生成文档、迁移计划、review reports、MCP 设置说明和 subagent 任务说明。
升级为项目资产的流程
不要提交每个生成输出。只有当它能节省重复劳动、有负责人并且可验证时，才升级为项目 artifact。
- 先在聊天或临时文件中草拟。
- 把稳定指令移动到 CLAUDE.md、AGENTS.md、commands、hooks 或 docs。
- 添加验证说明和存在理由。
- 命令或依赖变化时审查过期 artifacts。
相关生成器
对可重复格式使用生成器，然后在团队共享前审查输出。
常见问题
Claude Code artifacts 只指文件吗？
不是。它也可以是 review report、可复用提示词、设置说明或团队想保留的结构化输出。
每个 artifact 都应该提交吗？
不应该。提交共享且不含密钥的 artifacts；私有笔记、凭证和本地专用配置不要进仓库。
Artifacts 和 hooks、subagents 有什么关系？
当 hooks、command 文件和 subagent briefs 变成可复用项目资产时，它们就是 artifacts。
最适合先做哪个 artifact？
先从 CLAUDE.md 或 AGENTS.md 开始，工作流重复后再加入 hooks 和 custom commands。