eve-repo-upkeep

Eve 仓库维护

按照 Eve 规范维护应用仓库。各项检查彼此独立——需要处理多个方面时，可并行运行。

适用场景

• Eve 平台更新或清单架构变更后
• 重大部署或发布前
• 新维护者加入时

阶段 1：评估

快速确定哪些方面需要关注。检查以下文件是否存在，以及是否过时——不要逐个深入阅读文件，只需记录哪些方面需要处理：

• .eve/manifest.yaml — 是否存在？架构行是否为 eve/compose/v1？
• skills.txt — 是否存在？是否有固定版本或已过时的条目？
• AGENTS.md / CLAUDE.md — 是否引用了当前技能？
• agents/ 目录 — 是否存在 agents.yaml、teams.yaml、chat.yaml？
• 代码库 — 是否有明显过时的 CLI 用法或内联密钥？

如果只需处理一个方面，直接处理即可。否则，进入阶段 2。

阶段 2：分派工作者

为每个需要更新的方面创建一个工作者。以下每项工作者说明均自成一体——工作者无需了解其他工作者的上下文，即可独立完成相应工作。

工作者：清单对齐

检查并修复 .eve/manifest.yaml：

• 确保包含 schema: eve/compose/v1。
• 优先使用 services:，而非旧版 components:。
• 确保 x-eve 的入口和流水线定义准确。
• 确保 x-eve.defaults 与运行框架默认值（harness/profile/options）保持一致。
• 确保 x-eve.agents 配置与编排策略保持一致。
• 确保 x-eve.agents.config_path 和 x-eve.chat.config_path 指向有效文件。
• 确认密钥使用 ${secret.KEY}。
• 部署流水线应在 release 步骤前包含 build 步骤。
• 使用 Docker 镜像的服务应定义 build.context。
• 仅为自定义 BYO 注册表配置注册表身份验证密钥（REGISTRY_USERNAME + REGISTRY_PASSWORD）。

工作者：技能文件

检查并修复 skills.txt：

• 确保 Eve 技能包引用保持最新。
• 移除已过时的软件包或固定版本。

工作者：Agent 指令

检查并修复 AGENTS.md、CLAUDE.md 和 agents/ 配置文件：

• 更新技能引用，加入 eve-se-index。
• 移除过时的命令或 URL。
• agents/agents.yaml 定义 Agent 和技能——确认条目均为最新。
• agents/teams.yaml 定义团队组成和分派规则——确认结构正确。
• agents/chat.yaml 定义聊天路由规则和权限——确认规则正确。

工作者：过时模式

搜索代码库中的过时模式，并修复或标记出来：

• 旧 CLI 命令（eve deploy 与 eve env deploy）
• 缺少 --ref 参数的旧部署语法
• 文档或清单中的硬编码域名
• 仓库文件中的内联密钥
• 缺少指向仓库 URL 的 org.opencontainers.image.source 标签的 Dockerfile
• release 步骤前缺少 build 步骤的流水线
• 使用 Docker 镜像但未配置 build.context 的服务
• 自定义注册表缺少注册表身份验证密钥（REGISTRY_USERNAME、REGISTRY_PASSWORD 或提供商对应的名称）

阶段 3：验证

所有工作者完成后，运行最终验证：

# Local validation (Docker Compose)
docker compose up --build

# Staging deploy (requires --ref with 40-char SHA or a ref resolved against --repo-dir)
eve env deploy staging --ref main --repo-dir .

# Use --direct to bypass pipeline if needed
eve env deploy staging --ref main --repo-dir . --direct

使用 eve job follow 跟踪部署任务。