经明确批准生成 AI 使用画像，为独立 Skillware Repo 接入持续进化 Harness。
简体中文 · English · 主功能 · 适用场景 · 演示 · 安装 · 可见标记 · 工作方式 · 安全 · Changelog
EvoZeus 优先帮助用户看清自己如何使用 AI，并让已交付的 Skillware 持续吸收真实反馈。当前画像只支持本机 Codex 历史；历史读取、Factor 执行和报告写入都需要明确批准，目标 Repo 修改和 GitHub 操作也需要单独授权。
真实使用 → 证据 → 判断 → Lesson → 用户确认 → 修复验证 → 发布
- 生成 AI 使用画像：当前只支持本机 Codex 历史，先生成只读扫描计划。用户明确批准 Codex 历史读取与报告写入后，生成 AI 使用习惯、优势与盲区、人格画像（例如
INTJ 倾向）报告。画像来自 Session 行为证据，证据不足时会明确说明。 - 让 Skillware 持续进化：检查用户指定的 Skill、Plugin 或路径所在的独立 Git Repo，先生成接入计划，经批准后接入 EvoZeus-CoEvolve Harness，让真实反馈进入 Feedback、Design、PR、UAT 和 Release 闭环。
单次 Session 复盘、Lesson 记录、功能发现、Stable/UAT、Doctor、更新和回滚继续作为支撑能力提供。
EvoZeus 当前优先解决两类高频问题：产品需要尽快进入真实使用，以及交付后的 Skill 需要持续吸收客户反馈。
| OPC · 从快速 MVP 到工程化产品 | FDE · 从客户交付到持续迭代 |
|---|---|
| 适合谁 借助 Agent 独立构建产品的 One Person Company。 |
适合谁 向客户交付 Skill 的 Forward Deployed Engineer 与项目团队。 |
| 核心问题 MVP 可以快速上线，但真实用户暴露的问题容易散落，产品长期停留在“能跑”的状态。 |
核心问题 Skill 进入客户工作流后，反馈分散在群聊、私信、演示与验收中，难以追踪和复用。 |
改进链路快速 MVP → 真实使用 → Lesson → 修复 → UAT → Stable |
改进链路交付 Skill → 客户使用 → 确认 Lesson → Repo 修改 → 客户 UAT → 发布 |
| EvoZeus 如何帮助 ① 先让 MVP 上线，在真实场景中暴露边界。 ② 把用户纠正和失败案例提炼成可复用 Lesson。 ③ 区分产品、Skill、环境与执行问题。 ④ 让确认后的变化进入验证、唯一 UAT 和正式发布。 |
EvoZeus 如何帮助 ① 为独立 Skill Repo 接入受治理的进化 Harness。 ② 在正常业务对话中提示可复用 Lesson。 ③ 记录前先确认并脱敏，raw session 默认留在本地。 ④ 把反馈、修改、验证、UAT、发布和回滚连成一条链。 |
| 结果 保留 MVP 的上线速度，逐步获得可验证、可维护、可回滚的工程质量。 |
结果 把一次性交付转化为可持续维护、可验收、可交接的 Skill 产品。 |
下面两段短视频展示完整链路：先让一个已有 Skill 进入可维护生命周期，再把一次用户不满意转化为团队可检查、可授权的改进输入。
在保留业务行为的前提下，为独立 Skill Repo 补齐源头、版本、验证、反馈和发布治理。
50 秒自动循环演示 · 下载 MP4 原视频
保持正常聊天简洁；发现可复用 Lesson 后先征得授权，再创建可评审的 Feedback Issue。
39 秒自动循环演示 · 下载 MP4 原视频
官网负责完整安装与注册旅程。在兼容的 Agent 宿主中粘贴下面一行：
加入 EvoZeus: https://evozeus-community.vercel.app/skill
- 先只读检查本机 CLI、
version、Doctor 和关键状态，归入 fresh、健康 no-op、更新、修复、迁移或停止六类路径； - fresh candidate 在任何产品下载或
~/.evozeus写入前运行同一份 Stable preflight，明确依赖、fallback、阻塞项和修复建议； - 只有
not_installed可进入 fresh install，其他状态保留现有版本与 rollback 证据并走对应路径； - 说明本地写入和联网行为，在安装与注册前取得批准；
- 自动识别 Codex、Claude Code 或两者，注册唯一的
evozeusPlugin，并同步 Runtime 与 Plugin 到同一渠道； - 安装后运行 Doctor，启用渠道内自动更新，并在 Host 需要重新加载时提示开启新会话。
Preflight 全程不下载产品、不解压、不注册、不写入 ~/.evozeus。健康最新版直接返回 no-op；Preflight 与安装后的 Doctor 分别负责“能否安全进入安装路径”和“产品是否完整可用”。第一版 preflight 只接受 Stable，UAT 在 Stable 健康后通过已安装渠道流程单独进入。
官网是唯一公开安装交接入口，README 不复制第二套安装命令。Stable 健康后，用户可以单独选择是否进入唯一 UAT。
企业 AI 场景诊断 Skill 是理解 EvoZeus 用法的真实业务 Demo。它已发布 Stable v0.1.0；Stable SKILL.md 固定输出三个互不重复的候选场景、一个首选场景和一个带量化通过条件的最小验证动作。当前 main 的 Harness manifest 记录 EvoZeus-CoEvolve v0.14.0、canonical Repo 和 prompt_runtime_check 集成方式。
一家提供企业软件定制服务的公司，销售线索来自多个群聊，售前方案主要依靠个人经验，历史案例分散。请诊断三个适合优先验证的 AI 场景。
一次完整体验包含四个时刻：
| 时刻 | 业务动作 | EvoZeus 动作 |
|---|---|---|
| 1. 运行 | 提供企业背景，请 Demo Skill 诊断三个优先验证场景并选出一个首发场景 | 核验当前 Repo、Harness 版本与集成方式，显示受管运行身份 |
| 2. 纠正 | 指出某个候选场景缺少现有输入、证据缺口或量化通过条件 | 先补全业务诊断，再总结一条可复用 Lesson |
| 3. 确认 | 决定是否记录 Lesson | 只有用户确认后才创建 Skill Feedback Issue |
| 4. 进化 | 单独授权修改目标 Repo | 让已批准变化进入 Design、PR、验证、UAT 和 Release |
Demo 解释产品如何使用；安装和注册始终走上方官网 /skill 入口。
完成安装后，先从两项主功能开始：
先为我生成本机 Codex 历史扫描计划并等待明确批准；当前只支持 Codex，批准前不要读取历史。批准后生成 AI 使用习惯、优势与盲区、人格画像（例如 INTJ 倾向）报告。
为我指定的独立 Skillware Repo 接入 CoEvolve Harness；先检查并给出计划，修改 Repo 或 GitHub 前等待我的明确批准。
列出 EvoZeus 的全部功能，并检查当前安装和 Stable/UAT 状态。
功能列表中仍可直接选择单次 Session 复盘、记录已确认 Lesson、Doctor、更新和回滚。
EvoZeus 在正常聊天中给出结果。生命周期事件使用紧凑标记：
🧙 EvoZeus · 捕捉到一条 Lesson｜版本检查不应阻断用户的真实任务。要记录下来吗？
正常 Lesson 提示不会输出内部 JSON，用户确认前不会写入记录。
这些是 EvoZeus 的完整用户可见生命周期标记。它们出现在正常聊天中，用来说明 EvoZeus 何时介入、当前处于哪个阶段、是否已经获得验证；普通分析和每次工具调用不会刷标记。
| 你看到的标记 | 代表什么 | 什么时候出现 |
|---|---|---|
🧙 EvoZeus · 已启动｜复盘这次 Agent 执行 |
EvoZeus 已被显式调用 | 开始一次 EvoZeus 任务 |
👁️ EvoZeus · 受管运行｜企业 AI 场景诊断 Skill · UAT |
当前 Skillware 已进入受管生命周期 | Repo、Harness、渠道身份均已核验 |
🧙 EvoZeus · 捕捉到一条 Lesson｜证据不足时不能直接报完成。要记录下来吗？ |
发现了值得复用的改进 | 业务结果完成后，记录前先询问 |
📝 EvoZeus · Lesson 已记录｜Feedback Issue #12 |
已按授权保存 Lesson | 本地记录或 Issue 创建成功后 |
🔐 EvoZeus · 等待确认｜创建 Feedback Issue |
下一动作会写入或影响外部系统 | 需要新的具体授权时 |
🧭 EvoZeus · 版本状态｜Stable v0.4.0 → UAT v0.4.1 |
正在判断安装或渠道变化 | 对齐、升级、切换前 |
🧭 EvoZeus · 发现更新｜Stable v0.4.0 → v0.4.1 |
当前订阅渠道有新版本 | 自动检查发现变化后 |
🛠️ EvoZeus · 自动更新中｜正在对齐Plugin、Runtime、Session Signal与CoEvolve |
产品级更新事务已开始 | 下载与验证期间 |
✅ EvoZeus · 自动更新完成｜Stable v0.4.1 · 新会话加载Plugin |
新产品已通过验证并切换 | 自动更新成功后 |
🛡️ EvoZeus · 自动更新失败｜继续使用Stable v0.4.0 / 恢复未完成 |
已验证恢复时继续使用上一版；恢复未完成时需要人工处理 | 更新、Plugin 对齐或恢复失败后 |
🛠️ EvoZeus · 进化中｜example-skill · 修复验收门禁 |
已开始实施获批修改 | 修改授权已取得后 |
🧪 EvoZeus · UAT 就绪｜example-skill · abc1234 |
唯一 UAT 候选已经通过门禁 | 测试和候选更新完成后 |
🚀 EvoZeus · 已发布｜example-skill · v1.2.0 |
Stable Release 已真实存在 | 正式发布完成后 |
↩️ EvoZeus · 已回滚｜Stable v1.1.0 |
已恢复上一份可用版本 | 回滚并通过 Doctor 后 |
🛡️ EvoZeus · 暂停｜缺少可脱敏的验证证据 |
当前安全或证据条件不足 | 继续执行会越过边界时 |
✅ EvoZeus · 已验证｜Plugin、Runtime 与渠道一致 |
声明完成所需检查已通过 | 最终交付前 |
标记只反映真实状态：计划不会显示成完成，UAT 不会显示成 Stable。完整合同见用户可见生命周期标记。
启动方式取决于 Agent 宿主：
| 宿主 | 行为 |
|---|---|
| Claude Code plugin | 内置 SessionStart 适配器加载 Lesson 检查合同并检查当前产品渠道；已是最新时保持安静，只在更新状态变化时显示标记 |
| Codex plugin | 通过用户显式请求或语义匹配选择 EvoZeus；进入 EvoZeus 或 CoEvolve 受管 Skill 时检查版本 |
两种宿主都先完成用户任务，再询问是否记录 Lesson。
- 复盘：读取用户放入范围的会话、文件、diff、报告或明确批准的本地来源。
- 判断：把发现路由为 Preserve、Promote to Skill、Keep as Habit、Fix Environment、Reject Pattern 或 Open Case。
- 确认：发现可复用 Lesson 时，用一句话总结并询问是否记录。
- 改进：把确认后的 Lesson 转化为可检查产物；独立 Skillware Repo 可接入 EvoZeus CoEvolve。
EvoZeus 是一个本地产品和一个版本化发布：
| 能力面 | 作用 |
|---|---|
| Agent plugin | 自然语言入口与任务路由 |
| 用户 Skills | 复盘、Lesson 记录、Repo 进化、版本维护 |
| 产品 CLI | Stable/UAT 对齐、Doctor、更新与回滚 |
| 内置 Runtime | 本地证据处理与报告 |
| 内置 Session Signal pack | 官方复盘信号与 Factor tools |
| 可选 CoEvolve | 独立 Skillware Repo 的进化生命周期 |
Runtime 与 Session Signal 是主仓内部模块，随 EvoZeus 产品版本一起发布，用户无需分别升级。
stable是不可变正式 Release。uat是唯一可覆盖的测试候选。- Stable 和 UAT 都会在运行入口自动检查并更新，默认最多每小时访问一次远端清单。
- 自动更新始终留在当前渠道；Stable 不会自动切到 UAT。
- UAT 修复覆盖当前候选，不产生第二个用户可见 UAT。
- Stable 与 UAT 的代码和本地状态隔离。
- 正式发布使用已经验证的同一份 UAT 源码。
- Codex/Claude 中始终只有一个活动
evozeusPlugin；切换渠道会覆盖重装它，不会生成第二个 UAT Plugin。
已安装的 Stable v0.4.0 及更旧版本需要一次显式对齐进入 v0.4.1+，之后的同渠道更新才会自动运行。已激活自动刷新的 v0.4.0 UAT 可以直接从覆盖后的 uat/current 完成迁移。
用户批准后，官网安装流程调用同一个对齐事务：
evozeus align --channel stable --host auto --approve-write --json进入测试时把 stable 改为 uat。普通用户不需要手工维护 marketplace、worktree 或 Plugin 缓存。
详细语义见 ADR-0003；产品架构见 ADR-0005。
进化 Harness 的治理单位是 Git Repo，因为 Issue、PR、Owner、UAT、Release 和回滚都在这个边界上发生。
- 一个独立 Git Repo 最多拥有一个根 Harness；
- package、pack、app 和 Skill 目录继承所在 Repo Harness；
- CI 拒绝嵌套 Harness；
- Harness 升级和推送需要目标 Repo 已验证的
ADMIN权限。
完整规则见 Harness 边界策略。
- raw private session 默认保留在本地。
- 不自动上传会话。
- 首次安装授权包含当前渠道内的已验证自动更新；渠道切换、GitHub 修改和外部上传仍需单独确认。
- 用户可在
~/.evozeus/update-policy.json关闭自动更新或调整检查间隔。 - 公开产物必须移除 secret、客户数据、私有路径、无关身份和未发布代码。
- 运行历史 Skill 会调用已安装启动器检查当前渠道；验证失败时继续使用上一版。
npm ci
npm test
npm run test:python
python3 scripts/check_pr_ready.py --allow-cross-layer关键文档：
- MetaInFlow/EvoZeus-CoEvolve：面向独立 Skillware Repo 的可选进化扩展与 Harness SDK。
MIT，详见 LICENSE。