58 lines
4.5 KiB
Markdown
58 lines
4.5 KiB
Markdown
# 宠小它 Agent Team
|
||
|
||
本目录是宠小它项目的 agent 协作规则源头，迁移自 xxxfresh 的固定团队模型，并按当前宠物门店 SaaS 业务边界改写。
|
||
|
||
## 使用顺序
|
||
|
||
1. 先读 [common-context.md](common-context.md)。
|
||
2. 再读 [fixed-team-operating-model.md](fixed-team-operating-model.md)，确认 `Owner Agent`、`Paired QA`、`Workstream` 和 `Service Lock`。
|
||
3. 涉及接口、数据、权限、报告 token、媒体文件、成片任务或发布时，读取 [rules/api-contract-boundary.md](rules/api-contract-boundary.md)。
|
||
4. 按任务类型读取 [roles](roles) 下的角色规则。
|
||
5. 用 [templates/task-brief.md](templates/task-brief.md) 编写任务说明。
|
||
6. 跨模块方案先用 [templates/system-architect-review-checklist.md](templates/system-architect-review-checklist.md) 做架构评审。
|
||
7. agent 完成后用 [templates/review-report.md](templates/review-report.md) 输出结果。
|
||
|
||
## 当前角色
|
||
|
||
新任务默认只分派给固定 Owner Agent。专项支持 agent 可被固定 owner 拉入，但不默认持有固定队列。
|
||
|
||
### 固定 Owner Agent
|
||
|
||
| Owner Agent | Role 字段 | 规则文件 | 主要职责 |
|
||
|---|---|---|---|
|
||
| Store Miniapp FE | `Store Miniapp Frontend` | [store-miniapp-frontend-agent.md](roles/store-miniapp-frontend-agent.md) | 门店端老板/员工页面、预约、报告填写、我的、服务类型、员工管理 |
|
||
| Store Admin FE | `Store Admin Frontend` | [store-admin-frontend-agent.md](roles/store-admin-frontend-agent.md) | 门店 Web 管理后台 `admin/**` |
|
||
| Customer Experience FE | `Customer Experience Frontend` | [customer-experience-frontend-agent.md](roles/customer-experience-frontend-agent.md) | 宠主预约、报告 H5、分享落地、留资、宠物档案与公开体验 |
|
||
| Backend Core | `Backend Core` | [backend-core-agent.md](roles/backend-core-agent.md) | 预约、门店、用户、宠物、日程、服务类型、微信/短信基础能力 |
|
||
| Report Media Backend | `Report Media Backend` | [report-media-backend-agent.md](roles/report-media-backend-agent.md) | 报告、图片/视频素材、成片任务、报告公开页数据、留资、评价 |
|
||
| Core Flow QA | `Core Flow QA` | [qa-core-flow-agent.md](roles/qa-core-flow-agent.md) | 门店端和宠主端预约主链路验收 |
|
||
| Report Share QA | `Report Share QA` | [qa-report-share-agent.md](roles/qa-report-share-agent.md) | 报告填写、分享、H5、成片三态、隐私提示和埋点验收 |
|
||
| Backend Ops | `Backend Ops` | [ops-backend-agent.md](roles/ops-backend-agent.md) | 后端构建、配置、Nginx API、服务启动、回滚和 smoke |
|
||
| Frontend Release Ops | `Frontend Release Ops` | [ops-frontend-release-agent.md](roles/ops-frontend-release-agent.md) | 微信小程序、H5、静态构建、项目配置和前端 smoke |
|
||
| PM Assistant | `PM Assistant` | [pm-assistant-agent.md](roles/pm-assistant-agent.md) | 任务源维护、RC 管家、依赖、阻塞、验收证据和同步材料 |
|
||
| System Architect | `System Architect` | [system-architect-agent.md](roles/system-architect-agent.md) | 跨模块边界、接口契约、状态机、数据一致性和方案拆解 |
|
||
|
||
### 专项支持 Agent
|
||
|
||
| Agent | 规则文件 | 使用场景 |
|
||
|---|---|---|
|
||
| Data Model | [data-model-agent.md](roles/data-model-agent.md) | JPA 实体、表结构、索引、软删除、状态字段、幂等与迁移顺序 |
|
||
| Product Design | [product-design-agent.md](roles/product-design-agent.md) | 产品说明、用户流程、信息架构、交互文案、验收标准 |
|
||
| Docs | [docs-agent.md](roles/docs-agent.md) | 知识库同步、架构文档、研发计划、状态说明 |
|
||
| Progress Digest | [progress-digest-agent.md](roles/progress-digest-agent.md) | 项目进展摘要、实现度看板、日报素材 |
|
||
|
||
## 项目级边界规则
|
||
|
||
| Rule | 文件 | 使用场景 |
|
||
|---|---|---|
|
||
| API / 数据 / 隐私边界 | [api-contract-boundary.md](rules/api-contract-boundary.md) | 任一任务触碰后端 controller/service/entity/repository、`frontend/src/api`、报告 token、媒体 URL、用户手机号、门店数据范围或发布配置 |
|
||
|
||
## 分工原则
|
||
|
||
- 一个 agent 一次只负责一个清晰目标。
|
||
- 写入范围必须在任务开始前声明。
|
||
- 不同 agent 的写入范围应尽量互斥；同一 `Service Lock` 同时只允许一个 owner 修改。
|
||
- 主控 agent 负责集成、review 和最终决策。
|
||
- agent 不允许回滚自己职责范围外的修改。
|
||
- 产品说明类任务默认只写 `docs/`；只有负责人明确要求“改代码 / 实现功能”时才进入编码类任务。
|