# AGENTS.md

Easydict 是一款 macOS 词典和翻译应用，支持查词、文本翻译、划词翻译和 OCR 截图翻译。

`AGENTS.md` 是 Agent 的唯一任务入口；详细规则只在对应专题文档维护。

## 任务模式

### 计划模式

- 用户要求方案、分析、解释或评估时，只读取和检查现状并给出答复，不修改文件、Git 或外部服务。

### 执行模式

用户要求修改、修复、更新、实现或执行时，按以下顺序完成任务：

1. **执行前**：首次写入前读取任务路由要求的专题规则；任何可能产生仓库差异的任务都必须读取
   `exec-plans/README.md` 与 `histories/README.md`，并按其规则判断 plan 和 history。
2. **实现与验证**：完成范围内的修改并运行风险匹配的验证；失败时修复并重新验证。
3. **Review**：生产代码、复杂逻辑、跨模块或高风险变更在验证通过后使用
   [`review`](.agents/skills/review/SKILL.md) 技能审查；修复有效 finding 后重新验证和审查。
   纯文档及简单低风险变更除外。
4. **交付**：更新 history，完成并归档已有 plan；必要验证和适用的 Review 通过后自动创建本地
   提交，用户明确要求不提交或没有差异时除外。

### 通用规则

- 用户可能会出错；发现用户有明显错误或决策冲突时，应明确指出并说明原因。
- 无法确认修改授权时保持只读；从计划模式转入执行模式后，从“执行前”开始。
- 用户的禁止、范围和顺序要求优先；push、创建 Pull Request、发布及其他外部写入仅在用户明确
  要求时执行。
- 回复使用用户当前请求的语言；已有文档保持原语言；代码标识、API 名称、命令、路径、品牌名称
  和固定输出契约保留原文。
- 现行规则文档单一职责，跨职责使用链接，不复制条款；文档使用相对仓库路径，
  不提交机器本地绝对路径。
- 历史记录与设计文档只在被当前任务明确采用时才构成约束。

## 任务路由

- 只读取当前任务需要的专题规则。
- Git 分支命名：统一遵循
  [`git-commit` 分支命名规范](.agents/skills/git-commit/references/branch-naming.md)。
- 构建、测试、工程文件与资源、Xcode 验证：[`build-and-test.md`](docs/agents/build-and-test.md)。
- 跨语言代码质量、Swift、Objective-C、SwiftUI、API 和本地化：
  [`coding-guidelines.md`](docs/agents/coding-guidelines.md)。
- 计划与 history 记录：[`exec-plans/README.md`](docs/exec-plans/README.md) 与
  [`histories/README.md`](docs/histories/README.md)。
- 参考资料与外部证据：[`references/README.md`](docs/references/README.md)。
- 外部 Skills 和同步边界：[`skills.md`](docs/agents/skills.md)。
- 产品代码、跨功能行为或模块边界：
  [`application-architecture.md`](docs/design-docs/application-architecture.md)。
- 公共使用或贡献者文档：[`en/zh`](docs/user-docs/)。