用途:为 Codex CLI 及其他非 Claude 智能体初始化 sd0x-dev-flow 基础设施。安装方式为 npx skills add sd0xdev/sd0x-harness。
主要能力:init 首次设置,生成 AGENTS.md、安装 commit-msg 钩子并复制脚本;doctor 校验安装完整性(文件存在、AGENTS.md 哈希匹配、已记录钩子处于活动状态);sync 在技能更新后重新生成 AGENTS.md 并更新已安装的钩子与脚本。无子命令时默认执行 init。
参数:--with-push-gate 适用于 init 与 sync,将 pre-push-gate.sh 安装为 pre-push 钩子,默认关闭。该门控会读取 /dev/tty 等待人工确认,在非交互环境可能挂起或失败,因此需显式开启;commit-msg 钩子默认安装,因为它只读取提交信息做判断,不提示输入,但会拒绝违规提交(策略违规退出 1,无法评估策略退出 3)。
init 流程:检测仓库根(git rev-parse --show-toplevel)、读取 package.json 与 CLAUDE.md 提取测试命令、定位插件根;用 node <plugin-root>/scripts/build-codex-artifacts.js --project-dir <repo-root> --output <repo-root>/AGENTS.md 生成内核,若文件已存在会先警告并询问是否覆盖,并校验文件非空、不超过 24 KiB、无未解析占位符;随后按优先级安装钩子:存在 .husky/ 时复制脚本到 .claude/scripts/ 并向 .husky/<hook> 前置执行片段;设置了 core.hooksPath 时安装到该路径;.git/hooks/ 可写时直接写入;否则写入 .githooks/ 并提示执行 git config core.hooksPath .githooks。
限制:写入专用钩子文件前会按内容分类目标,非 sd0x 所有的既有钩子不会被覆盖,而是记录为 pending 并提示移动或重命名后重试;Husky 模式采用前置并执行的方式,以保留 git 通过 stdin 传递的 ref 列表。资料未提供收费、价格、平台支持范围等信息。