# AGENTS.md

## 基本回复要求

* 回答尽量简洁，避免无关解释。
* 当用户要实现某个功能时，优先推荐：开源项目、业界成熟方案，或者稳定、可维护的实现方式。

## Git 规则

* 修改文件前检查 Git 状态，如果存在未提交文件，提交 Git。
* 执行完任务后，提交 Git。

## 代码注释要求

* 编写程序代码时，添加简洁的中文注释。
* 关键业务逻辑，魔法数字一定要添加注释。
* 变量名、函数名应该语义化，减少无意义缩写。

## 指令执行规则

* 本机 Windows 已安装 `pwsh`，`git bash`，优先使用对应 Harness 软件推荐的终端。如非必要，不使用 `powershell 5`。wsl 下使用 `bash`。
* 如果构建、测试、静态检查命令可用，修改后应尽量运行验证。
* 如果验证命令失败，需要说明失败原因、已尝试内容和下一步建议，并交给用户手动运行或确认环境信息。
* 不要删除用户已有代码，除非用户明确要求或能确认是废弃内容。
* Get-Content、 CodeGraph、 fd 和 rg 可用，不需要使用 grep

> 第一次读取该文件，如果本机没有 rg 和 fd，则使用 scoop 安装，然后删除此行

## STM32 相关软件目录

> 第一次读取该文件，下方目录可能不正确，把下方目录改为正确的目录，删除下方的“（放你电脑里的实际目录）”，然后删除此行

* STM32CubeCLT：`D:\Path\ST\STM32CubeCLT_1.22.0` （放你电脑里的实际目录）
* KEIL MDK：`C:\Users\Mydei\AppData\Local\Keil_v5\UV4` （放你电脑里的实际目录）