复现已有算法

2026-07-14 15:43:18 +08:00
parent abebd2a683
commit 50b8111fd9
860 changed files with 182250 additions and 18 deletions
@@ -0,0 +1,81 @@
+---
+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 文件，是否未提交。