AGENTS.md

wx-cli Agent Rules

每次改完代码后必须做的事

1. cargo check — 改任何 .rs 文件后立刻运行，不通过不提交
2. 改了跨平台代码时加运行跨平台 check：

   cargo check --target x86_64-unknown-linux-gnu
   cargo check --target x86_64-pc-windows-msvc

3. 改了 Cargo.toml 版本号时： cargo update --workspace

禁止行为

• 不能在 cargo check 失败的情况下 commit
• 不能只在 macOS 本地 check 就认为跨平台没问题
• 不能改完 Cargo.toml 不更新 Cargo.lock 就打 tag

常见陷阱

陷阱	正确做法
libc::__error() 在 #[cfg(unix)] 里	用 std::io::Error::last_os_error()
把通用 dep 放到 [target.cfg(windows).dependencies] 后面	TOML section 是贪婪的，通用 dep 必须在 target section 之前
改版本号忘更新 Cargo.lock	cargo update --workspace
Windows 代码用 trait method 忘 import trait	use std::os::windows::process::CommandExt 等
#[cfg(windows)] 里引用了未定义的函数	跨平台 check 会发现

Push 规则

• remote 名称：wx-cli，使用 SSH
• 每次 commit 后立刻 push
• 打 tag 用 git tag vX.Y.Z && git push wx-cli vX.Y.Z