用途:这是 Agentera v1 遗留的 /hej 入口桥接技能,只面向仍安装旧版 /hej 的用户,用于把旧安装引导到 Agentera v2 的单一入口 /agentera(在 Codex 中为 $agentera)。注意:单独发送文本 hej 不属于此桥接,而属于内置 agentera 技能及其 agentera hej 仪表盘路径。不要运行 v1 的 HEJ 引导流程,也不要生成 v1 仪表盘。
主要能力:加载后先用通俗语言说明这是旧 /hej 入口,Agentera 现从 /agentera 启动。随后检查项目中是否存在尚无 v2 YAML 对应文件的 v1 Markdown 产物:.agentera/PROGRESS.md 无 progress.yaml、PLAN.md 无 plan.yaml、DECISIONS.md 无 decisions.yaml、HEALTH.md 无 health.yaml、DOCS.md 无 docs.yaml,以及根目录 VISION.md 无 .agentera/vision.yaml。若存在旧状态,列出受影响文件并运行或提供预览命令,明确说明预览不改变任何内容:uvx --from git+https://github.com/jgabor/agentera agentera upgrade --project "$PWD" --dry-run。
使用方式:应用更改前须征得用户同意,并说明应用步骤会安装或修复本地应用、更新受管运行时界面、把旧项目笔记转换为新格式并保留备份,且不会编辑 shell 启动文件。确认后使用:uvx --from git+https://github.com/jgabor/agentera agentera upgrade --project "$PWD" --yes。仅当用户明确批准 npx skills remove 或 npx skills add 等包管理命令时才加 --update-packages。若无 v1 项目状态,仅在 /agentera 不可用且用户明确批准包管理命令时,提供仅更新包:uvx --from git+https://github.com/jgabor/agentera agentera upgrade --only packages --yes --update-packages。最后提示用户调用 /agentera(Codex 中为 $agentera)。
限制与安全:未经用户明确确认,绝不改动项目产物或运行时安装;绝不要求 Agentera 编辑 shell 启动文件,doctor 或 setup_copilot.py 报告的 1.x 受管标记块属用户手动清理,升级不扫描 shell 启动文件;优先使用 uvx --from git+https://github.com/jgabor/agentera,因为旧用户可能未克隆仓库;若从本地检出运行 scripts/agentera,本地等价命令为 uv run scripts/agentera upgrade ...。