Quoin Skill 技能

技能简介

Quoin 是一款面向无状态编码 Agent 的工作流记忆与状态管理工具包，通过将规划、架构笔记、评审产物、门禁、会话交接、经验沉淀和成本账本等结构化产物落到 .workflow_artifacts/ 目录，让多个会话之间的工作流状态可被精确传递而不再仅靠模型记忆。它同时为 Claude Code 提供全局 Skill+Hook+记忆文件适配器，为 Codex 提供 repo 级 AGENTS.md 与便携工作流契约，两条路径共享核心语义但运行环境隔离。截至 2026 年 10 月已发布到 PyPI 0.42.0 版本。

核心能力

• 结构化工作流产物：规划、架构、评审、门禁、会话交接、经验沉淀、成本账本全部以可预测文件名落在 .workflow_artifacts/，会话之间通过文件而非对话历史传递上下文。
• Claude Code 全局适配器：通过 quoin install --runtime claude 一键部署 Skill、脚本、Hook、记忆文件和工作流规则到 ~/.claude/，支持 user 级与 project 级两种 scope。
• Codex repo 级脚手架：自动生成 AGENTS.md 并指向便携工作流契约，使用 Codex 原生的规划、审批、沙箱、repo 级指令与模型推理控制，不污染全局。
• 成本纪律：Claude 路径提供实时成本工具，Codex 路径写入便携成本行并将不可用遥测字段如实标记为 not_available，而非编造数字。
• 运行时可移植：共享工作流语义集中在 quoin/core/，Claude 与 Codex 的运行时差异隔离在各自的 adapter 目录中，未来新增运行时（如 OpenCode、Gemini CLI）只需新增 adapter。
• 会话连续性：两个运行时路径都会在 .workflow_artifacts/memory/sessions/ 下保留交接状态，新会话启动时自动读取。

安装配置

1. pip install quoin 安装 Python 包本体（要求 Python 3.10+）。
2. quoin install --runtime claude 部署 Claude Code 全局适配器；非交互环境下默认 user 级 scope，CI 中可用 --scope user 显式指定。
3. quoin doctor --runtime claude 检查安装完整性，包括解释器路径、quoin-runtime.json 注册记录、Hook 是否就位。
4. Codex 用户只需在项目目录运行 quoin install --runtime codex，会自动生成 AGENTS.md 与便携工作流契约。

使用步骤

1. 启动 Claude Code 或 Codex 编码 Agent 后，技能自动注册到工作流。
2. 在 Agent 中描述要实现的功能，Quoin 自动引导完成架构 → 规划 → 实现 → 评审 → 门禁五阶段，每阶段产物落到 .workflow_artifacts/。
3. 关闭会话后，下一次启动 Agent 时通过读取会话交接文件自动续上之前的工作流进度，无需复述上下文。
4. 使用 quoin install 后台记录的 quoin-runtime.json 自动续接：detached hand-off 可重新拉起同一解释器版本而非猜 PATH。
5. 切换运行环境（如 Claude Code → OpenCode）时，仅需新增 adapter，无需迁移工作流数据。

适用场景

• 多会话跨日的复杂功能开发，避免每次启动 Agent 都要从头解释上下文。
• 团队协作中的编码 Agent 工作流标准化，让 review、门禁、交接都按统一约定进行。
• 长期项目（季度级演进）中的架构决策记录与沉淀，避免 Agent 反复推翻过去的设计。
• Claude Code 与 Codex 双工具协作场景，两边共享同一份工作流语义但隔离运行环境。
• 需要成本透明度的生产级 Agent 部署，确保每次会话的成本可追溯、可对账。

适用人群

• 在 Claude Code / Codex 上做大型长期项目的开发者，需要会话间工作流可恢复。
• 团队技术负责人，希望把分散在多人 Agent 中的工作流约束统一收敛。
• AI 工程效能团队，在企业内部推行可审计、可复盘的编码 Agent 工作流。
• 独立开发者管理多个并行项目，每个项目都需要独立的工作流产物目录。

工作原理

Quoin 设计的核心是 artifact-centric workflow：所有规划、架构、评审、门禁、成本、交接都以文件形式落到 .workflow_artifacts/，让文件系统而非 LLM 记忆成为 Agent 之间的协议层。两条运行时（Claude Code 与 Codex）共享 quoin/core/ 中的核心语义，但 Claude 走 install 全局 hook+skill，Codex 走 repo 级 AGENTS.md，避免相互污染。安装时记录的 quoin-runtime.json 让 autonomous run 的 detached hand-off 能精准复活原解释器，避免 PATH 漂移导致跑错版本。

官方链接

• PyPI：https://pypi.org/project/quoin/
• GitHub：https://github.com/FourthWiz/quoin
• 文档：https://github.com/FourthWiz/quoin#readme