cloud
2.5 KiB
2.5 KiB
name, description
| name | description |
|---|---|
| edge-skill-builder | 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
只写：
---
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 后执行：
python3 /home/cloud/.codex/skills/.system/skill-creator/scripts/quick_validate.py .agents/skills/<name>
同时检查：
grep -R "Java\\|Spring\\|K3s\\|Ant Design\\|Umi\\|one_person" -n .agents/skills/<name> || true
如果出现这些词，要确认是项目真实需要，还是外部 skill 残留。
输出
最终向用户说明：
- 新增或修改了哪些 skill。
- 每个 skill 覆盖什么场景。
- 是否通过校验。
- 是否只改了 skill 文件，是否未提交。