Skip to content

Latest commit

 

History

History
53 lines (36 loc) · 1.84 KB

File metadata and controls

53 lines (36 loc) · 1.84 KB

安装指南

通过 plugin marketplace 安装

codex plugin marketplace add itstarts/development-workflow --ref v0.2.0
codex plugin add development-workflow@development-workflow

plugin 只包含 developing-software skill,不包含 Hooks 或项目专属 Agent 配置。安装会改变当前用户的 Codex plugin 状态,必须由用户明确执行或授权。

上述 marketplace 固定到 v0.2.0 tag。命令成功只证明安装状态已更新;正式产物一致性和新任务中的 skill 加载仍需分别验证。

只安装 skill

python3 \
  "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
  --repo itstarts/development-workflow \
  --ref v0.2.0 \
  --path skills/developing-software

固定到经过验证的不可变 tag。安装完成后启动新 Codex 会话,使 skill 列表重新加载。

安全更新

不要直接修改正式安装副本。先安装到临时 CODEX_HOME,再只读比较:

.venv/bin/python scripts/verify_install.py \
  --codex-home /path/to/staging-codex-home \
  --skill developing-software

返回码:

  • 0:publishable payload 完全一致;
  • 1:存在 missing、extra 或 different;
  • 2:参数、路径、读取或文件类型无效。

该命令不写入目标目录,也不能证明 plugin 已加载。正式安装、Hook/skill 可见性、发布和运行时调用仍是不同状态。

从 v0.1.x 迁移

v0.2.0 不再发布以下内容:

  • 六 skill 的 PRD/spec/plan/prompt/routing/rule-governance 链;
  • collaboration guard Hook;
  • 仓库内的三种 reviewer 配置;
  • 8/14 字段 handoff 和 evaluation 状态机。

更新 plugin 后启动新会话,确认只剩 developing-software。旧 tag 和历史文件仍可从 Git 历史恢复;不要在未验证新候选前删除正式安装。