pua-cancel-loop：Codex 循环取消命令
一键取消正在运行的 PUA 循环，清理状态与工作树引用。
该技能会修改用户主目录下的 ~/.pua/config.json，仅明确提及进行清理操作，未涉及权限剥离或额外数据外传。但未提供回滚或备份机制，且未明确用户确认步骤。仓库中发现的 upload 功能（collecting JSONL 会话日志）不属于当前技能路径，但暗示了潜在的数据流。扣分原因：缺少回滚机制和明确的最小权限说明。
技能文件提供了清晰的操作指令，但缺乏错误处理说明和测试覆盖。代码路径简单，但未提供任何失败反馈机制或异常输入处理。扣分原因：静态审查无法执行，且文件内容不足以证明可靠运行。
技能针对明确的场景（取消 PUA 循环），但边界条件描述简略，触发条件未详细说明。中文描述，适用于中国用户，但未提及网络依赖。扣分原因：非适配范围未明确，触发精度可能不足。
技能文件遵循 SKILL.md 格式，有名称、描述、许可证（MIT），但缺少版本信息、更新日志和维护责任说明。仓库整体有 README 多种语言，但当前技能未提供示例或 FAQ。扣分原因：信息架构不完整，缺少版本和常见问题。
该技能的核心任务是清理状态和取消循环，从描述看应能正确执行，但缺乏实际运行证据或示例输出。作为 Codex 别名，它能提供便捷性，但边际价值有限。扣分原因：无执行结果验证，无法确认输出直接可用性。
仓库中包含 CI 工作流和测试文件（如 upload-function.test.ts），但它们针对其他功能，不覆盖本技能。因此没有针对本技能的可验证测试。扣分原因：关键路径未经过可复现的第三方验证。
- 该技能会修改 ~/.pua/config.json，建议在执行前确保有备份或确认机制。
- 仓库中的贡献上传功能（收集 JSONL 会话日志）可能存在隐私风险，虽然不属于当前技能，但请注意。
- 本技能未提供失败回滚或恢复方案，若清理操作出错可能导致状态不一致。
这个 Skill 能做什么，适合哪些场景？
pua-cancel-loop 是专为 Codex CLI 设计的别名命令，对应 Claude Code 的 /pua:cancel-loop 用法，通过 $pua-cancel-loop 调用。它负责取消当前活跃的 PUA 循环：清理循环状态文件和工作树引用，并记录取消事件。修改 ~/.pua/config.json 时保留未知字段，若 ~/.pua/ 不存在则自动创建。该技能仅为 45 个技能集合中的一个，不包含其他技能的功能。
该技能具体执行以下操作：1) 定位并删除 PUA 循环的状态文件（如 ~/.pua/ 下的相关文件）；2) 清理与循环关联的工作树引用；3) 在 ~/.pua/config.json 中记录取消事件，同时保留未知字段；4) 若 ~/.pua/ 目录不存在则自动创建；5) 在调用后提供命令或输出证据，避免虚假完成声明。
- 当用户通过 Codex CLI 启动了 PUA 循环，但发现循环陷入死循环或不再需要时，使用 $pua-cancel-loop 立即停止。
- 开发者在多项目环境中切换任务，需要清理之前遗留的循环状态，避免干扰新任务。
- 在自动化脚本中，当检测到循环超时或条件满足时，调用此命令作为安全阀，终止循环并清理环境。
- 当用户明确要求停止循环时，通过此命令确保状态文件被正确清理，防止后续会话误判循环仍活跃。
这个 Skill 有哪些优点和局限？
- 提供明确的循环取消机制，避免循环失控。
- 自动清理状态文件和工作树引用，保持环境整洁。
- 保留未知字段，避免破坏配置。
- 操作简单，一条命令即可触发。
- 仅作为别名存在，依赖 Codex CLI 的 SKILL.md 机制，不含独立脚本。
- 工作树引用的具体清理方式未在文档中详细说明，可能依赖外部工具。
- 该技能仅为集合中一个，单独提取无法获得完整 PUA 功能。
- 许可证为 MIT，但仓库未明确维护者责任，可能缺乏长期支持。
如何安装这个 Skill？
安装此技能需先安装整个 tanweai/pua 存储库。对于 Codex CLI，可使用官方一键安装：运行 Fetch and follow instructions from https://raw.githubusercontent.com/tanweai/pua/main/.codex/INSTALL.md，或手动安装：创建目录 mkdir -p ~/.codex/skills/pua-cancel-loop，并将 codex/pua-cancel-loop/SKILL.md 的内容保存为 ~/.codex/skills/pua-cancel-loop/SKILL.md。注意，当前仓库未提供单独安装该技能的命令。
如何使用这个 Skill？
安装后，在 Codex CLI 会话中输入 $pua-cancel-loop 即可触发。例如，在对话中直接输入 $pua-cancel-loop。该命令会执行取消循环的操作，并根据输出确认成功。