AgentLife

Imported from zzzc411/AgentLife (AGENTS.md). Install upstream with npx skills add zzzc411/AgentLife. Copyright stays with the author.

AgentLife Codex 工作手册

开始涉及 AgentLife 改造前，先阅读该设计文档的相关章节。

Codex 按需加载规则

Codex 使用就近 AGENTS.md 作为模块化规则：根目录放全局红线，各子目录放该模块专属约束。修改某个文件时，同时遵守它所在目录链路上的所有 AGENTS.md。

当前模块手册：

• Life/Life-java/AGENTS.md：Java 主业务、internal API、RabbitMQ、MySQL 落库。
• Life/Life-agent-service/AGENTS.md：Python Agent、LangGraph、工具边界、记忆与输出。
• Life/nginx-1.18.0/html/life/AGENTS.md：移动端页面与前端调用边界。
• Life/Life-agent-service/tests/AGENTS.md：Python Agent 测试约束。
• Life/Life-java/src/test/AGENTS.md：Java 测试约束。
• docs/AGENTS.md：设计文档与测试报告约束。
• scripts/AGENTS.md：脚本、压测、辅助工具约束。

全局红线

1. 原 Java 核心业务继续由 Java 负责，不能破坏登录、店铺、优惠券秒杀、库存扣减、订单、点赞、关注、Feed、签到等既有链路。
2. Python Agent 不得直接连接或操作 MySQL。
3. Python Agent 不得抢券、下单、扣库存、创建订单或调用秒杀接口。
4. 前端只调用 Java 接口，不直接调用 Python Agent。
5. Java 与 Python Agent 只能通过 RabbitMQ 传递任务、进度和结果。
6. Docker 复用原 MySQL 和 Redis，只新增 RabbitMQ；不要引入 Kafka、ES、向量库等新中间件，除非设计文档已明确进入对应阶段。
7. Redis 保存 Agent 热记忆、最近对话、任务状态和进度。
8. MySQL 由 Java 保存长期记忆、任务结果、消息和日志。
9. 本地文件只保存 Python Agent 临时中间产物，不保存 token、手机号、密码等敏感信息。
10. 简单任务不走多 Agent；只有复杂消费决策任务才走多 Agent。
11. 所有 Agent 输出必须包含结构化 JSON 和用户可读 answer。

工作方式

• 保持改动小而可验证，优先延续现有包名、接口风格和数据结构，代码要有清晰的中文注释。
• 新增跨模块能力时，先确认 Java / Python / 前端 / MQ 的职责边界，不把业务写操作下沉给 Agent。
• 涉及安全、记忆、日志、MQ、测试时，优先查阅对应子目录的 AGENTS.md。