seed

Seed

AI Workflow System for Game Development

基于 Claude Code Plugin 的游戏研发 AI 工作流系统
动态 Agent 组装 · CC Native Team 编排 · 项目记忆持久化 · Fragment-based Skill 注入

---

什么是 Seed

Seed 是一个专为游戏研发场景设计的 Claude Code 插件。它的核心能力是根据任务特征（类型、领域、复杂度）自动选择合适的 Agent 组合，通过 Claude Code 原生 Agent Team 机制协调执行，并跨 session 保持项目上下文。

Seed 不是通用 AI 编排框架——它专注于游戏开发领域，内置了面向 Unity / Godot / Unreal / Cocos 的引擎主线知识，以及 Lua、配置表、网络、CI/CD、工具链等跨引擎能力知识。

核心特性

• 动态 Agent 组装 — 根据任务的 task_kind / domain / complexity 三个维度自动路由到最优 Agent 组合
• CC Native Team 编排 — 直接使用 Claude Code 原生 Agent Team（TeamCreate / TaskCreate / SendMessage），不维护任何自己的进程
• 项目记忆持久化 — .seed/project-memory.json 存储长期项目知识，每次 session 自动注入，抗 compact
• Fragment-based Skill 注入 — 按 prompt 关键词匹配，自动注入相关技能片段到上下文
• Context Guard — 监控上下文使用率，超阈值自动提醒 /compact
• Memory Editor — 本地 Web UI 可视化管理三大知识层（Constitution / Auto Memory / Project Knowledge），内置后台 Worker 服务和 Agent SDK 任务队列

---

安装

Seed 仅支持通过 Claude Code Plugin 机制安装：

# 1. 添加 marketplace 仓库
/plugin marketplace add https://github.com/buyun00/Seed-GameDev-Harness.git

# 2. 安装插件
/plugin install seed

# 3. 运行初始化向导
/seed:setup

安装流程详解

安装分三个阶段自动执行：

阶段	触发时机	做什么
plugin-setup.mjs	/plugin install 后自动执行	保存 Node 路径到 ~/.claude/.seed-config.json，将 hooks.json 的 node 替换为绝对路径（兼容 nvm/fnm/Windows）
setup-init.mjs	首次打开 CC session	创建 .seed/state、.seed/logs、.seed/plans 目录结构
/seed:setup	用户手动运行	语言选择、安装 CLAUDE.md、写入默认配置、启用 Agent Teams、创建 /seed 快捷命令、引导运行 /seed:embed

/seed:setup 五阶段向导

1. 语言选择 — 选择交互语言（English / 中文 / 日本語 / 한국어），后续所有提问、文档输出、注释均使用选定语言
2. CLAUDE.md 安装 — 选择 local（.claude/CLAUDE.md）或 global（~/.claude/CLAUDE.md），安装 Seed 核心指令
3. 默认配置写入（静默） — 自动写入 .seed/config.json、启用 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1、创建 /seed 快捷命令
4. 引导运行 /seed:embed — 提示用户重启 Claude Code 后运行 /seed:embed 分析项目技术栈
5. 完成确认 — 写入 setupCompleted 标记

---

使用

命令体系

命令	性质	说明
/seed	日常入口	项目快捷命令，转发到 /seed:bud。由 /seed:setup 自动创建到 .claude/commands/seed.md
/seed:setup	一次性初始化	语言选择、CLAUDE.md 安装、默认配置写入、引导运行 embed
/seed:embed	项目画像扫描	扫描引擎、语言分布、语言职责和目录结构，写入项目记忆
/seed:bud	底层引擎	实际的 bud 命令实现（通常通过 /seed 调用，无需直接使用）

提示：如果输入包含"配置/config/设置/改一下"等关键词，/seed 会提示你运行 /seed:setup，不会继续执行任务组装。

/seed — 动态组装 Agent Team

/seed 实现跳跃手感优化
/seed --auto 调查帧率下降问题
/seed --confirm Review the new combat system
/seed --guided 重构战斗系统架构

模式：

模式	行为	适用场景
auto	分析后直接启动	日常使用
confirm	展示方案，一次确认后启动	需要确认方案
guided	逐步引导，可调整参数	首次使用或复杂任务

/seed:embed

/seed:embed          # 扫描并覆盖当前项目画像
/seed:embed --check  # 只扫描并展示摘要，不写入文件

扫描内容：

• 主引擎与版本，例如 Unity 2022.3.15f1。
• 脚本/代码语言分布，例如 C#、Lua、GDScript、TypeScript。
• 语言职责判断，例如 Lua = gameplay primary，C# = Unity host/bridge/tooling。
• 关键目录地图：路径、用途、证据、置信度。

写入文件：

• .seed/project-memory.json
• .seed/project-profile.md

---

Agent 角色

Agent	定位	职责	限制
leader	常驻协调者	方向仲裁、计划维护、closeout 签字	不直接实现代码
builder	实现主力	编写代码、修复 bug、交付功能	方向选择必须升级给 leader
researcher	按需调查员	信息收集、根因分析、调查报告	不写/编辑文件
reviewer	按需审查员	代码审查、方案审查	不写/编辑文件
unity-pilot	Unity 操作员	Unity Editor 操作、Play Mode 验证	不写 C# 逻辑代码

---

记忆系统

层	文件	用途	写入时机	读取时机
Project Memory	.seed/project-memory.json	长期项目知识：tech stack、project profile、hot paths、directives	/seed:embed 和 PostToolUse	SessionStart / PreCompact
Project Profile	.seed/project-profile.md	人类可读项目画像	/seed:embed	用户审阅
Notepad	.seed/notepad.md	会话笔记：Priority Context / Working Memory / Manual Notes	Agent 主动维护	SessionStart

项目记忆注入保持短摘要，包含 [Project Environment]、[Project Profile]、[Hot Paths]、[Directives] 和 [Recent Learnings]。

---

Memory Editor（记忆编辑器）

Memory Editor 是 Seed 内置的本地 Web UI，用于可视化管理 Claude Code 项目中的三大知识层级。它在 Claude Code session 启动时自动拉起一个按项目隔离的后台 Worker 进程，提供 HTTP API + SSE 实时推送 + 静态页面托管。

解决什么问题

Claude Code 的知识体系分散在 CLAUDE.md、.claude/rules/、~/.claude/projects/<slug>/memory/、docs/ 等多处文件中，缺乏统一的结构化视图。Memory Editor 将这些知识抽象为可浏览、可编辑、可审计的对象，所有 AI 修改必须经过 Proposal → Diff 审查 → 用户确认 才会写入文件。

三大管理页面