@weotro/dx 0.1.12 → 0.1.14

package/skills/cc-ship-issue-pr/references/runtime.md

@@ -1,85 +0,0 @@
-# Claude Code Runtime Contract
-
-仅在共享流程进入外部专家或 follow-up 分支时读取。
-
-## Codex 通道
-
-Codex 永远不碰 Git 历史和 GitHub。它把改动落在工作树，由 Claude Code 主进程核验、验证和分组提交。
-
-- **方案讨论 / 实现 / 重修复**：`Agent(subagent_type: "codex:codex-rescue")`。
-- **普通 review**：Codex companion 的 `review` 子命令。
-- **adversarial review**：Codex companion 的 `adversarial-review` 子命令。
-- **定制上下文审查**：只读 `Agent(subagent_type: "codex:codex-rescue")`，prompt 明确禁止写操作和递归委派。
-
-companion 每次调用都动态解析插件路径：
-
-```bash
-CODEX_ROOT=$(/bin/ls -d ~/.claude/plugins/marketplaces/openai-codex/plugins/codex 2>/dev/null \
-  || /bin/ls -d ~/.claude/plugins/cache/openai-codex/codex/*/ 2>/dev/null | sort -V | tail -1) \
-  && node "$CODEX_ROOT/scripts/codex-companion.mjs" --help
-```
-
-插件升级会换版本目录，不把解析结果硬编码回技能。
-
-普通 review：
-
-```bash
-CODEX_ROOT=$(/bin/ls -d ~/.claude/plugins/marketplaces/openai-codex/plugins/codex 2>/dev/null \
-  || /bin/ls -d ~/.claude/plugins/cache/openai-codex/codex/*/ 2>/dev/null | sort -V | tail -1) \
-  && node "$CODEX_ROOT/scripts/codex-companion.mjs" review --wait --base main
-```
-
-需要挑战方案时把 `review` 换成 `adversarial-review`。需要定制上下文时改派只读 Codex agent。
-
-## 补跑清单
-
-Codex 沙箱不能绑本地端口、不能起 PostgreSQL 共享内存、不能写主仓 `.git` index、无网络下载。派发 prompt 原文附上以下主进程补跑项：
-
-`dx db migrate`（实 apply）、后端 E2E、`dx build front --dev`、`flutter test`、Dart OpenAPI 生成（要下 Maven）、`git commit`。
-
-## 取结果
-
-`codex:codex-rescue` 可能转后台。按 `workspaceRoot` 精确匹配当前仓库：
-
-```bash
-python3 - <<'PY'
-import glob, json, os
-root = os.path.realpath(os.getcwd())
-rows = []
-for f in glob.glob(os.path.expanduser('~/.claude/plugins/data/codex-openai-codex/state/*/state.json')):
-    for j in json.load(open(f)).get('jobs', []):
-        if os.path.realpath(j.get('workspaceRoot', '')) == root:
-            rows.append((j.get('createdAt'), j.get('id'), j.get('kind'), j.get('status'), j.get('phase'), f))
-for r in sorted(rows)[-5:]:
-    print(r)
-PY
-```
-
-定位到 job 后读取同目录 `jobs/<id>.json`。只有 `status=completed` 且 `phase=done` 才算返回，报告正文取 `result.rawOutput`。
-
-## 等待与活性排查
-
-所有通道（含 follow-up）遵守共享流程的「委派活性与接管」规则。等待期间工作树由 Codex 独占，主进程只做不写工作树的并行事项。
-
-派发后保存本次 job/agent ID、worktree 和日志路径；上方按仓库列举 job 的脚本只用于发现候选，结合派发时间与任务信息确认后固定 ID，后续不得自动改查最新 job。保存派发基线，约每 2 分钟比较：
-
-- 本次 job 的新增日志、工具事件、输出正文，以及 `status` / `phase` 的实际变化。状态文件 mtime 刷新但内容未变不算进展。
-- 本次责任文件的内容变化：比较 `git diff --binary HEAD` 的内容指纹，并记录相关未跟踪文件的内容指纹；删除、新增、同一脏文件的再次修改都应被识别。只读审查不要求有文件修改。
-- 当前子命令与进程状态、权限请求或外部依赖等待。观测失败记为未知，不能当作无活动。
-
-连续多个观测窗口没有进展时，读取日志尾部和子命令状态，向原 agent 查询当前步骤及阻塞点；这个条件只触发排查，不触发停止或换执行者。重复错误、空心跳或无关文件变化不能证明任务在推进。
-
-companion 的 `review --wait` / `adversarial-review --wait` 也通过宿主异步工具启动，保留会话 ID 并读取输出和本次 job；宿主单次等待结束后继续观察同一会话，不给前台命令套固定时长的自动终止器。只有确认失败或排查证实无法推进，才按共享接管规则处理；正常运行但尚未返回不算通道不可用。
-
-## 阶段与报告映射
-
-- 阶段四方案讨论：只读 Codex agent；主进程先写初步方案，最终拍板权在主进程。
-- 阶段四实现与阶段 7.4 重修复：可写 Codex agent，prompt 要求不 commit、不 push、不碰 GitHub、不递归委派。
-- 阶段 7.3：先按共享流程复用已有审查；复杂度门禁命中且本次交付尚未用过 Codex 独立审查时执行 review（创建 PR 前的审查也计数）；需要挑战方案时执行 adversarial review。
-- reviewer：`Claude Code 主进程自审 / codex native review / codex adversarial review / codex 只读 subagent`。
-
-Codex 返回后主进程必须直读源码和 diff 核验，不采信转述。重改动实现通道不可用时阻塞；条件式独立审查不可用时由主进程完成本轮自审并在报告标明降级。
-
-## Follow-up
-
-使用 `Agent(subagent_type: "general-purpose", run_in_background: true)`，prompt 指定 worktree 绝对路径并要求调用 `cc-ship-issue-pr`。派发深度只允许一层；子 agent 发现的新 follow-up 只建 Issue。派不动 Codex 时子 agent 自己实现，并在 PR body 记录主进程直改。

package/skills/oo-ship-issue-pr/SKILL.md

@@ -1,27 +0,0 @@
----
-name: oo-ship-issue-pr
-description: 仅在用户显式调用 $oo-ship-issue-pr、/oo-ship-issue-pr 或明确要求使用 oo-ship-issue-pr 技能时使用；不要通过关键词、任务类型或上下文自动触发。
----
-
-# OO Ship Issue PR
-
-Codex 入口：主进程执行轻改动；Claude 咨询与独立审查调用 [ask_cc](../ask_cc/SKILL.md)，重改动实现与修复调用 [delegate-cc](../delegate-cc/SKILL.md) 的 `task` 模式。调用、模型选择和降级均复用这两个技能。
-
-## 步骤一：加载共享流程
-
-```bash
-AGENTS_ROOT="${AGENTS_HOME:-$HOME/.agents}"
-SHIP_CORE="$AGENTS_ROOT/references/ship-issue-pr-core.md"
-test -f "$SHIP_CORE"
-```
-
-完整读取 `SHIP_CORE` 后执行全部阶段。运行时映射如下：
-
-- 主进程：当前 Codex。
-- 外部专家：通过 `ask_cc` 或 `delegate-cc` 调用的 Claude Code；审查使用独立上下文，不复用实现或修复会话。
-- 入口显示名：`OO Ship Issue PR`。
-- Follow-up：Codex `spawn_agent` 的 `worker` 角色。
-
-第一次进入外部专家或 follow-up 分支前，完整读取 [references/runtime.md](references/runtime.md)。该文件是本入口的平台调用契约；共享流程仍是交付语义的唯一真源。
-
-只有共享流程全部完成且 `mergedAt` 非空、Issue 回访完成，才输出 `OO Ship Issue PR 完成`。

package/skills/oo-ship-issue-pr/references/runtime.md

@@ -1,50 +0,0 @@
-# Codex Runtime Contract
-
-仅在共享流程进入外部专家或 follow-up 分支时读取。
-
-## Claude 技能路由
-
-用户显式调用 `oo-ship-issue-pr` 后，按下表调用其依赖技能。先完整读取对应 `SKILL.md`，再执行其中的流程；路径相对于本文件，`dx initial` 会将这些技能安装在同一个 skills 根目录下。
-
-| 共享流程阶段 | 调用技能 | 本阶段目标 |
-|---|---|---|
-| 阶段四方案讨论 | [ask_cc](../../ask_cc/SKILL.md) | 只读咨询，裁决初步方案、备选与取舍 |
-| 阶段 7.3 review | [ask_cc](../../ask_cc/SKILL.md) | 对照 Issue 与当前 diff 返回独立 findings |
-| 阶段 7.3 adversarial review | [ask_cc](../../ask_cc/SKILL.md) | 挑战假设、不变量、反例与失败路径 |
-| 阶段四重改动实现、阶段 7.4 重修复 | [delegate-cc](../../delegate-cc/SKILL.md) 的 `task` 模式 | 按最终方案修改代码并提供验证结果 |
-
-本入口只补充交付上下文与验收要求。CLI 参数、模型顺序、权限配置、等待与超时、状态解析、接续及降级统一按依赖技能执行，不在这里另写调用脚本或重试链。依赖文件缺失时先运行 `dx initial` 恢复；仍无法读取时报告缺失路径，不临时仿写该技能。
-
-所有通道（含 follow-up）遵守共享流程的「委派活性与接管」规则。依赖脚本的 `--timeout` 是无活动告警阈值；读取其 PID、输出字节和文件观测摘要，疑似停滞时检查原会话与工作树。宿主单次等待结束后继续观察同一会话，不设置按总耗时自动终止的外层超时器，也不把尚未返回当作降级依据。
-
-## 交接上下文
-
-每次交接包含当前 worktree 绝对路径、阶段、Issue 原文与逐条验收标准、base，以及该阶段所需的方案、代码和验证证据。任务仅覆盖当前阶段，不运行完整 `oo-ship-issue-pr`；Git 历史、GitHub 操作、权威验证和最终事实核验由 Codex 主进程负责。
-
-### 咨询与独立审查
-
-`ask_cc` 的咨询模式无工具权限。主进程先读取适用的 `AGENTS.md`、相关源码和当前 diff，将必要内容连同文件路径、行号、验证结果写进咨询材料；审查材料覆盖整个 PR diff，另附影响判断所需的上下文。仅提供仓库路径或要求 Claude 自行读文件不构成完整交接。证据不足时由主进程补充材料后继续同一审查阶段。
-
-- 方案讨论：附主进程初步方案、备选与取舍、希望裁决的具体问题；最终方案由主进程拍板。
-- 普通 review：要求按严重级返回 findings，每项包含 `文件:行号`、证据、影响和具体修法。
-- adversarial review：先挑战方案假设、构造反例和失败路径，再按同样格式返回 findings。
-
-审查使用全新独立上下文，不复用实现或修复会话。通过依赖技能降级后，只有未参与实现或修复的独立执行者完成的审查才计入外部专家审查；主进程自审不得冒充独立审查。
-
-### 实现与修复
-
-按 `delegate-cc` 的任务书要求，附最终方案原文、可修改文件或模块、适用项目指令、验收标准及仓库实际验证命令。保护已有改动，只在指定 worktree 和分配范围内工作，改动留在工作树。需要 Claude 运行验证时按该技能声明允许的具体命令。
-
-## 验收与报告
-
-取得结果、等待停止、处理部分改动、接续或降级均按依赖技能执行。主进程取得最终结果后直读源码和 diff，核验结论、合并重复项并记录拒绝依据；仅派发成功或返回成功声明不算阶段完成。
-
-外部执行者的验证仅作参考。交接材料附本阶段需补跑的清单，并要求报告未运行的验证及原因；权威验证由 Codex 主进程执行并阅读输出。主进程已有验证按共享流程的证据复用规则承接，后续阶段只补跑缺失或失效项。
-
-阶段 7.3 仍服从共享流程的证据复用、复杂度门禁和每 PR 最多一次外部专家审查约束。创建 PR 前已有的独立外部审查也继续计数并按覆盖范围复用；同一阶段因证据不足补充材料或按依赖技能降级，不能被当作后续轮次重新派发审查的额度。
-
-reviewer 按实际执行者记录为 `Codex 主进程自审`、`Claude Code（ask_cc）review/adversarial review` 或实际降级执行者，并记录依赖技能返回的请求模型及降级情况。实现与修复记录使用 `delegate-cc task` 及实际执行者；自身接管的审查记为自审，不计入外部专家审查。
-
-## Follow-up
-
-完整 follow-up 包含 Git/PR 交付，使用 Codex `spawn_agent` 的 `worker` 角色在后台承接；Claude 技能只负责上表中的专家阶段。prompt 指定 worktree 绝对路径并要求调用 `oo-ship-issue-pr`。明确告知 worker 它不是代码库中唯一执行者，不回退其他人的改动，只在指定 worktree 工作。派发深度只允许一层；worker 发现的新 follow-up 只建 Issue。