它解决什么问题： 长任务被 ChatGPT 用量窗口打断后要靠人记住进度、重新提示；复杂任务又常把规划和执行交给同一个 Agent，既浪费推理预算，也缺少稳定验收。本包把精确续作、按风险路由、里程碑检查点装进 Codex。
唯一默认路线：Sol 负责规划与复核，Luna 负责执行。 v2.0.0 只提供纯 Sol–Luna 工作流；无配置即可使用，旧 v1 配置会安全迁移。
npx skills add shangzhimingge/codex-workflow-skills --skill '*' --agent codex --yes需要 Node.js 22.20+、Codex、Python 3.9+；自定义 Agent bootstrap 还需要 PowerShell 5.1+ 或 PowerShell 7+。
-
安装后，新建一个 Codex 任务并输入：
为当前项目新增 /health 接口，补测试并验证；如果用量窗口中断，重置后继续。 -
Skill 自动预检任务身份，并给出类似路线：
Route: Tier 2 - bounded, testable change; Scout: no; Planner: compact; Executor: luna -
Codex 记录路由、实施和验证检查点。若 included usage window 中断，窗口恢复后从同一 thread、同一 turn task 和同一工作区继续，而不是从头猜进度。
| 场景 | 使用前 | 使用后 |
|---|---|---|
| 用量窗口耗尽 | 手动保存进度、等待、重新描述上下文 | 识别中断并在重置后恢复精确任务 |
| 小改动 | 也可能启动重型规划 | Luna 直接执行并验证 |
| 复杂改动 | 一个 Agent 边猜边改 | Sol 先规划、Luna 执行、Sol 再复核 |
| 最终交付 | “应该完成了” | 用新鲜检查结果验收，并写入检查点 |
| Skill | 一句话定位 | 适合何时安装 |
|---|---|---|
codex-auto-resume |
用量窗口重置后，继续正确的 Codex 任务。 按真实 thread UUID、turn task 与 Git、普通目录或托管工作区注册，维护 daemon、watchdog 与检查点。 | 只需要自动续作，不需要 Agent 路由 |
sol-luna-handoff |
让 Sol 规划与复核，让 Luna 执行。 按范围和风险确定性选择 Tier 1/2/3。 | 只需要纯 Sol–Luna 分工，不需要自动续作 |
quota-aware-runner |
一次安装，把续作、路由、检查点和最终验证串起来。 自带 Auto Resume 运行时和五个 Agent 定义。 | 希望开箱即用的完整工作流 |
三者都可独立安装；quota-aware-runner 不依赖同包中的另外两个 Skill。
codex-auto-resume v1.5.4 延续 v1.5.0 的全工作区预检：每个用户 turn、自动恢复 turn 和子代理 trigger turn 各执行一次，问题咨询和非 Git 工作同样覆盖。注册键为 actual_thread_id + task_id + workspace_root；工作区可解析为 Git 根、普通目录或每 thread 托管目录。共享 daemon 只在合格预检注册或复用任务后按需启动。Windows 限额探测现在使用隐藏且启用 kill-on-close 的 Job Object，并以 PID + 创建身份绑定的后代快照处理挂接前子进程及分配失败；清理按终止 Job、隐藏 tree/身份安全进程终止、等待根进程及后代排空、最后关闭 Job 句柄的顺序执行，且不覆盖更早的 RPC 错误。POSIX 仍使用新会话与 TERM-to-KILL 清理。所有锁文件参与者都会通过按规范路径派生的 OS acquisition gate 串行执行创建、陈旧 owner 判定、清除和紧接重建：Windows 使用进程退出时自动释放的 named Mutex，POSIX 使用 advisory lock。持久 owner 只分为已消失、存活且身份匹配、未知或身份不匹配三态；权限与身份不确定性保持 fail-closed。恢复会同时快照锁内容与稳定文件身份，仅清除已确认消失且两次比较未变化的 owner；任一阶段发现锁消失时，即使 timeout 为零也立即重试，同时保留替换文件和新 owner nonce；daemon 与 watchdog 的锁和状态仍按 PID + 进程身份判活，其他真实权限错误不会被当作陈旧锁删除；daemon 在首次扫描前发布已验证身份和心跳，避免慢扫描造成启动握手误判。窗口恢复时仍按叶子优先顺序继续任务，运行时固定为 billing_policy=included_only。
身份缺失或冲突、显式 opt-out 或运行环境损坏时返回 SKIPPED。普通目录与托管工作区的快照只记录规范根目录和目录身份，不递归读取内容；Git 工作区继续使用可感知变更的快照。
sol-luna-handoff 与 quota-aware-runner 使用相同的 pure Sol–Luna v2.0.0 路由：
- Tier 1： 小而明确的改动，由 Luna 直接实施和验证。
- Tier 2： 范围有界、策略明确、可独立验证时仍默认 Luna；需要时先由精简 Sol 规划。
- Tier 3： 安全、架构、部署、迁移等高风险或高歧义任务仍保留完整 Sol 规划与复核，默认由 Luna 执行。
Luna 遇到缺失的绑定决策或超出既定范围时，会先停下并保留 diff 与检查证据，交由 Sol 重新规划，而不是自行扩展范围。
工作流配置固定为 { "schemaVersion": 2, "workflow": "sol-luna" }。缺失配置直接选择纯 Sol–Luna；旧 v1 配置由安装器精确迁移。Tier 2 可按需运行 compact Sol 规划，Tier 3 始终执行完整 Sol 规划、Luna 实施与强制 Sol 复核。
quota-aware-runner 固定执行：
Auto Resume 预检
→ 五 Agent bootstrap 与纯 Sol–Luna 路由
→ 路由检查点
→ 实施与聚焦检查
→ 实施检查点
→ 新鲜验收验证
→ 验证检查点与 DONE
npx skills add shangzhimingge/codex-workflow-skills该命令会打开 Skill 选择器。若要无交互地把三个 Skills 安装到 Codex，请使用首页的一句话安装命令。
npx skills add shangzhimingge/codex-workflow-skills --skill codex-auto-resume --agent codex --yes
npx skills add shangzhimingge/codex-workflow-skills --skill sol-luna-handoff --agent codex --yes
npx skills add shangzhimingge/codex-workflow-skills --skill quota-aware-runner --agent codex --yesnpx skills add shangzhimingge/codex-workflow-skills --all--all 是 --skill '*' --agent '*' --yes 的简写。它会安装到全部受支持的 agents；只使用 Codex 时，优先使用首页的 Codex 定向命令。
sol-luna-handoff 和 quota-aware-runner 会检查五个 Agent：sol_planner、sol_compact_planner、luna_scout、luna_executor、luna_fast_executor。缺失时，它们从已安装 Skill 目录运行 scripts/install-agents.ps1。旧版受管执行器仅在精确哈希匹配时安全清理，自定义同名文件会让安装在写入前终止。
两者都遵循 CODEX_HOME，并在写入前检查冲突。sol-luna-handoff 幂等维护自己的全局 AGENTS.md 托管块与工作流配置；quota-aware-runner 只安装 agents，不改全局 AGENTS.md 或配置。新 Agent 通常从下一个任务开始可选，当前任务使用内置 fallback contract。
python tools/sync-composite.py --check
python -m unittest discover -s tests -p "test_*.py" -v
node tests/skills-cli-smoke.mjsWindows 上额外运行：
powershell -NoProfile -File tests/install-agents.tests.ps1
powershell -NoProfile -File tests/composite-install.tests.ps1# 更新已安装 Skills
npx skills update codex-auto-resume sol-luna-handoff quota-aware-runner
# 卸载单项
npx skills remove --skill quota-aware-runner --yes
# 卸载本包三个 Skills
npx skills remove --skill codex-auto-resume sol-luna-handoff quota-aware-runner --yes维护者流程见 docs/design.md，固定上游版本见 docs/upstream-provenance.json。
MIT © 2026 shangzhimingge。合并内容源自 shangzhimingge/codex-auto-resume 与 shangzhimingge/sol-luna-handoff。