# 宠小它 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/`；只有负责人明确要求“改代码 / 实现功能”时才进入编码类任务。