AGENTS.md

语言和风格

• 始终使用简体中文回复
• 直接回答问题，不要客套话
• 代码注释也用中文

代码规范

• 使用 2 空格缩进
• 变量名用驼峰命名（camelCase）
• 函数名用动词开头（如 getUserById）

工作习惯

• 修改代码前先阅读相关文件
• 不确定时先问，不要猜测
• 每次只做最小必要的修改

工作态度

• 每次工作都要用严谨的工作态度，保证完美的质量标准

沟通风格

• 直接输出代码或方案，禁止客套话（"抱歉"、"我明白了"等）
• 除非明确要求，否则不提供代码摘要

求真原则（禁止瞎猜）

• 不确定/信息不足时先查证或提问澄清
• 对环境/配置/源码/行为的结论必须有证据
• 回答里把"事实"和"推测/假设"分开写

#通用开发规则

代码质量原则

• 优先代码可读性，做最简单的修改
• 禁止使用 eslint-disable 或 @ts-ignore 绕过问题
• 禁止使用 any 类型，必须定义明确的类型
• 不要为了向后兼容而保留废弃代码
• 删除未使用的代码，不要注释掉

复用优先

• 编写新代码前，先确认项目中是否已有类似实现
• 优先复用现有组件和工具函数，而非新建

#工作流程规则

执行规范

• 任何非平凡任务，先制定计划再动手
• 修改代码前必须先阅读相关文件，做到多读少写

1. PLAN.md 模式 - 计划先行

核心: 模糊目标 → 可执行任务清单

• 任务拆分到 30分钟-2小时粒度
• 每个任务有明确完成标准（不是"做"，而是"验证通过"）
• 使用 - [ ] 复选框跟踪进度

2. Phase 迭代 - 小步快跑

核心: 大目标拆成独立 Phase，每个可独立交付

• Phase 之间尽量解耦（1-3 可并行）
• 每个 Phase 完成立即标记，给用户确定性
• 遇到阻塞先讨论再决定（不硬闯）

3. 测试即交付 - 验证闭环

核心: 没有测试 = 未完成

• 每个功能必须有验证方式（curl/python/人工）
• 问题发现后记录到 PLAN.md 修复清单
• 循环：写代码 → 测试 → 发现 → 修复 → 再测试

子代理调度策略

• 尽可能调用子代理完成任务
• 能派给专家的就派，不要什么都自己干