Ratchet 是一个用于在项目中建立或收紧合规护栏（guardrails）的技能，面向 IEC 62304 / ISO 14971 医疗器械软件开发。它支持新项目从零搭建（greenfield）、在已有项目中逐步改造（retrofit），以及升级已有护栏脚本。
用途 Ratchet 用于在项目中引导或改造出符合 IEC 62304 / ISO 14971 的开发护栏。适用于设置新的受监管项目、在已有项目中采用护栏，或更新已有护栏。其核心原则是：在已有项目中一次只收紧一步，绝不放松门禁，绝不覆盖人工工作。
主要能力
- 模式检测：区分 greenfield（无提交、无源文件、无 AGENTS.md/docs）与 retrofit（其他情况），以及升级模式（已有 .guardrails/scripts/ 并希望更新）。
- 多单元仓库支持：通过访谈确定单元（units）、合规范围外内容（not_a_unit）、安全等级（safety_class）、依赖关系（depends_on）和隔离控制（segregated_from），并写入 .guardrails/units.yaml 和各单元配置。
- 脚手架搭建：复制配置、脚本、模板（SRS、RMF、SAD、SOUP、problems、CONTEXT、GUIDELINES、CLAUDE.md、AGENTS-block.md），创建 docs/adr/、docs/plans/、docs/verification/，并更新 .gitignore。
- 差距分析：在 retrofit 中先做只读盘点，写出差距分析到 docs/plans/，然后逐步安装护栏。
- 安全等级访谈：依据 IEC 62304 4.3，通过提问确定 Class A/B/C，并记录为 ADR。
- 人工设置清单：复制并填写 references/setup-checklist.md，保存到 docs/plans/，要求 check-signing.sh --setup 退出码为 0。
- 工具确认：记录 guardrails_version 和 guardrails_commit，运行测试套件并记录结果。
使用方式 用户通过 /ratchet 调用，或要求设置、改造、更新项目护栏。当前目录即目标项目。技能会先定位护栏源（.guardrails-source 指定的目录，或其上两级的仓库），克隆到项目外的临时目录，所有复制和测试套件都读取该克隆，完成后删除。随后按步骤执行：检测模式、多单元访谈、脚手架或差距分析、安全等级访谈、人工设置清单。升级已有项目时，需先阅读 references/upgrade-notes.md，按顺序操作，并在复制前以升级模式运行 tailor-guidelines。
适用场景
- 新受监管项目的初始搭建。
- 已有项目逐步采用护栏。
- 已有护栏脚本的升级。
- 多单元仓库的合规管理。
限制
- 不覆盖人工工作，retrofit 只合并托管块（managed block）。
- 不放松门禁，一次只收紧一步。
- 提交签名是硬性要求，未满足前 ratchet 不算完成。
- 测试套件在克隆中运行，不在目标项目运行，且不安装 bats。
- 脚本在目标项目中不得修改。
- 具体收费、价格、平台等信息暂未提供。