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