agentsight-auto-format

代码自动格式化

目标

编辑 .rs、.py、.ts、.tsx 文件后，自动运行对应的格式化工具，保持代码风格一致。

触发时自动执行

每次编辑代码文件后（Edit、Write 等操作），对被修改的文件运行对应的格式化命令。格式化失败时静默跳过，不阻断工作流。

格式化规则

扩展名	命令	备注
.rs	rustfmt <file>	直接调用，不需要 crate 上下文
.py	ruff format <file>	没有 ruff 时用 black --quiet <file>
.ts .tsx	prettier --write <file>	需要本地已安装 prettier

注意事项

• 只格式化本次编辑的文件，不要全量格式化
• 格式化工具不存在时跳过，不报错
• 不要用 cargo fmt（需要 crate 上下文，对单文件不友好）
• 不要用 npx prettier（会触发网络下载，有供应链风险）
• 提交前仍需运行 cargo fmt --check / cargo clippy 做最终检查

Hook 自动化

本目录下的 post-edit-format.py 脚本可挂接到任何支持 PostToolUse hook 的 agent，实现机械式自动格式化。

脚本从 stdin 读取被编辑的文件信息（支持 hook JSON 和纯文本路径），自动分发到对应 formatter。用法：

echo "/path/to/file.rs" | python3 develop-skills/agentsight-auto-format/post-edit-format.py

各 agent 的 hook 配置方式不同，请参考对应 agent 文档将脚本挂在 PostToolUse（Edit/Write）事件上。hook 配置属于开发者本地设置，不提交仓库。