项目与角色模板

这是 cicy-code 最有价值的用法之一:agent 复用 + 项目记忆独立。目标 —— 定义一次「前端 / 后端 / 测试」这样的稳定 agent 模板,任何项目都能用它起 agent,且不同项目之间会话/记忆完全隔离。

两个原语

你要的	用什么	放哪
复用(稳定 agent 模板)	角色模板 role	~/cicy-ai/memory/agents/<slug>/
隔离(项目记忆独立)	项目模板 project	~/cicy-ai/memory/projects/<slug>.md

因为 agent 的 guidance = global + 项目 + 角色,创建时组装、写进各自 workspace(记忆与模板),所以:同一个「前端」角色在不同项目各起一个 agent,就是各自独立的 workspace / 记忆 / 对话 —— 天然隔离。

一、做三个角色模板

每个角色一个目录,含:

~/cicy-ai/memory/agents/前端工程师/
├── role.md        # 英文人设 / 职责(落进 agent 的 CLAUDE.md)
├── role.zh.md     # 中文人设
├── system.md      # 系统提示(cicy 每轮的 system 字段)
└── meta.yaml      # name / name_zh / tools 白名单 / greeting / max_tool_rounds

meta.yaml 示例:

name: Frontend Engineer
name_zh: 前端工程师
tools: [agent-chrome, cicy-agent, cicy-todo]
greeting_zh: 我负责前端组件与联调。

role.md 里写清职责边界(比如"React/Vite 组件与联调,不实现后端接口")。后端、测试同理各建一个目录。

想发给所有机器

把三个角色目录放进打包 seed api/mgr/embed/memory-seed/agents/,发版后所有机器开箱即用;只想本机用就放 ~/cicy-ai/memory/agents/。

二、每个项目建项目模板

~/cicy-ai/memory/projects/<项目名>.md

里面写这个项目的规则、技术栈、约束(会作为 project 层组合进该项目下每个 agent 的 guidance)。

三、起 agent

新项目来了:

1. 建 projects/<项目名>.md;
2. 用「前端 / 后端 / 测试」三个角色各起一个 agent,project 选该项目。

→ 3 个专职 agent,记忆各自独立;换个项目重复步骤,两项目之间互不串味。

可选:PM 编排 + fork

也可以让一个「项目 PM」agent 绑定项目,再固定 fork 出前端/后端/测试三个职能(fork 继承角色 + 项目)。这是编排层的糖 —— 底座仍是角色 + 项目模板。

相关

• Fork 分身 · 定制记忆