用途:Smith 是 Forge 的编排型超级技能,输入一个目标或已就绪的 issue,负责挑选路径并决定人类监督的密度。它自身不添加阶段行为,每一步都是已有技能或 forge 命令,贡献的是判断力:在门禁之间尽量自主推进,但到门禁处刻意停下,目标是对话式自主而非无人值守。
主要能力与流程:用 triage-ready 从就绪队列(forge issue ready --json)中排序并解释首选为何可做,就绪是派生模型需每次重算;用 claim-safety 认领并证明所有权,FORGE_ACTOR=<actor> forge claim <id> 后用 forge issue owns <id>(退出码 0 表示拥有),claim 返回 ok:true 不算证明;规划时按规模×重要性×复杂度映射到 lean/standard/high 层级并向人类提议,人类确认或覆盖;按变更分类(critical/standard/simple/hotfix/docs/refactor)驱动 plan → dev → validate → ship → review → verify;每个启用的门禁前运行 forge gate check <issue> <gate>,退出 0 才继续,否则请人类 forge gate approve 或 reject,用 forge gate status 查看历史;关闭前再次证明所有权并运行 forge release check --target <version> --json,健康且拥有时才 forge close <id> --reason "…",然后 forge sync。
自主层级:Lean 仅强制 gate.merge 或在 CI 下禁用人类门禁;Standard(默认)强制 gate.intent、gate.plan-approval、gate.merge;High 强制全部三个并加里程碑检查与发布前检查。层级是逐 issue 决定,不切换仓库配置;forge gate disable <gate-id> 才是仓库级关闭。
限制与可靠性:人类始终优先,不确定时增加监督;恢复后依据记录事件而非记忆重查门禁;所有权需证明两次;不得绕过门禁或钩子(不用 LEFTHOOK=0、--no-verify)。具体层级到门禁映射见 references/autonomy-and-gates.md。