wind_power_cal/.claude/skills/edge-codex-automation/SKILL.md

name, description

name	description
edge-codex-automation	edge_collector Codex 自动化任务建设规范。用于新增、修改或评审自动化任务、定时检查、自动部署验证、远程主机巡检、日志汇总、报告生成等流程时，明确执行边界、调度来源、脚本位置、通知、手工验证和安全限制。

edge_collector Codex 自动化

适用场景

• 定时检查云平台或边缘主机状态。
• 自动生成巡检报告。
• 自动构建或验证，但不自动发布。
• 自动拉取日志、磁盘、CPU、内存信息。
• 自动检查 docs、skills、配置格式。

设计原则

• 自动化只能做边界清晰、可回滚、可验证的任务。
• 涉及部署、重启、清库、删除、覆盖配置时必须有人确认。
• 自动化脚本要独立，不能和 edge 主服务强耦合。
• 运行日志必须可追溯。
• 失败要有明确提示和下一步处理建议。

建设流程

1. 明确目标：

   • 自动化要解决什么问题。
   • 成功标准和失败标准。
   • 运行在哪台主机、哪个目录。

2. 明确调度：

   • 一次性、定时还是手动触发。
   • cron、systemd timer、CI 或其他调度器。
   • 时区和执行频率。

3. 明确权限：

   • 是否需要 SSH。
   • 是否需要 sudo。
   • 是否会修改远程状态。
   • 是否访问密钥或配置文件。

4. 落地脚本：

   • 脚本放到 scripts/ 或 .agents/ 约定目录。
   • Shell 遵循 shell-scripting。
   • Python 脚本保持独立、参数清晰、日志明确。

5. 手工验证一次：

   • 先 --dry-run 或只读模式。
   • 再执行真实任务。
   • 检查退出码、日志、输出文件。

当前项目自动化边界

允许默认自动化：

• 只读巡检。
• 构建验证。
• 文档/skill 校验。
• 日志采集和摘要。
• 接口健康检查。

必须确认后才执行：

• deploy_cloud.sh
• scripts/migrate_edge.sh
• install_all.sh
• systemd restart/stop。
• 数据库写入、清理、重置。
• 删除文件、清理 /tmp、覆盖运行配置。

输出格式

自动化任务：
- 名称：
- 目标：
- 执行脚本：
- 调度方式：
- 运行主机：
- 权限需求：
- 日志位置：
- 手工验证：
- 风险：