---
name: edge-skill-builder
description: edge_collector 技能建设规范。用于从外部仓库、已有流程、项目经验、框架/SDK 学习结果中创建或改写 .agents/skills 下的 Codex skills，要求结合当前 C++/Drogon/React/Vite/云边部署/现场主机实际情况，避免原封不动照搬无关技术栈。
---

# edge_collector 技能建设

## 目标

把项目中重复出现的流程和判断沉淀为 `.agents/skills/<name>/SKILL.md`，让后续任务能稳定复用。

## 适用来源

- 当前仓库脚本，如 `deploy_cloud.sh`、`package.sh`、`scripts/migrate_edge.sh`。
- 已完成的故障排查和现场经验。
- 外部仓库中的通用 skill。
- 官方文档或 SDK 调研结果。
- 用户明确确认的长期规则。

## 命名规则

- 使用小写短横线。
- 本项目专用优先加 `edge-` 前缀。
- 云平台专用可用 `cloud-` 前缀。
- 名称要表达动作或场景，例如 `edge-frontend-testing`。

## frontmatter

只写：

```yaml
---
name: <skill-name>
description: <做什么 + 什么时候使用 + 当前项目关键上下文>
---
```

`description` 必须包含触发词，例如“部署云平台”“前端测试”“协议适配”“同步到97”。

## 改写原则

- 先读当前仓库真实文件，再写 skill。
- 保留流程骨架，替换成当前工程技术栈。
- 删除 Java、Spring、K3s、Ant Design、Umi、ClickHouse 等与当前工程不匹配的固定假设，除非当前文件真实使用。
- 不写通用教程，只写能指导本仓库工作的规则。
- 不把临时现场处理写成永久规则。

## 当前项目必须体现

- C++ collector 和 Drogon 后端。
- React/Vite/CSS Modules 前端。
- `runtime/edge` 与 `runtime/cloud_server`。
- `package.sh`、`deploy_cloud.sh`、`scripts/migrate_edge.sh`。
- 82/97/94/87 边缘主机和云服务器 `119.45.4.75`。
- 运行态动态配置不能被打包或同步覆盖。
- 用户可见文档不能透露内部技术细节。

## 校验

新增或修改 skill 后执行：

```bash
python3 /home/cloud/.codex/skills/.system/skill-creator/scripts/quick_validate.py .agents/skills/<name>
```

同时检查：

```bash
grep -R "Java\\|Spring\\|K3s\\|Ant Design\\|Umi\\|one_person" -n .agents/skills/<name> || true
```

如果出现这些词，要确认是项目真实需要，还是外部 skill 残留。

## 输出

最终向用户说明：

- 新增或修改了哪些 skill。
- 每个 skill 覆盖什么场景。
- 是否通过校验。
- 是否只改了 skill 文件，是否未提交。