petstore-docs/.agents/README.md

宠小它 Agent Team

本目录是宠小它项目的 agent 协作规则源头，迁移自 xxxfresh 的固定团队模型，并按当前宠物门店 SaaS 业务边界改写。

使用顺序

1. 先读 common-context.md。
2. 再读 fixed-team-operating-model.md，确认 Owner Agent、Paired QA、Workstream 和 Service Lock。
3. 涉及接口、数据、权限、报告 token、媒体文件、成片任务或发布时，读取 rules/api-contract-boundary.md。
4. 按任务类型读取 roles 下的角色规则。
5. 用 templates/task-brief.md 编写任务说明。
6. 跨模块方案先用 templates/system-architect-review-checklist.md 做架构评审。
7. 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/；只有负责人明确要求“改代码 / 实现功能”时才进入编码类任务。