用途：在仓库中完成 Forge 的安装、配置、升级与诊断，属于引导与维护类命令，区别于日常开发工作流阶段。
安装与配置：forge setup 默认交互式配置编码代理（Claude/Cursor/Codex 等）；自动化场景应加 --yes（或 --non-interactive）避免阻塞。可用 --agents claude,cursor --skip-external 指定目标并跳过服务提示，--path <dir> --dry-run 预览且不写入。
初始化新仓库：forge init 写入 Forge 采用配置 .forge/config.yaml。--minimal 等价于 --profile minimal --yes；也可用 --profile standard --harness claude,cursor，或 --classification standard --dry-run 预览。profile 决定强制程度：minimal（rails 关闭）→ standard → full。
诊断：forge doctor 仅报告 Forge 内核数据库路径的文件系统类别（本地/云同步/网络），用于发现将数据库放在 OneDrive、Dropbox 或网络共享上的可靠性隐患，并非通用健康检查；--json 输出机器可读结果。
升级准备：forge upgrade --dry-run 预览自愈步骤，forge upgrade 应用安全的自愈步骤使仓库可升级；它不更新已安装的 npm 包，需用包管理器完成。
全局钩子：forge hooks install --global 为所有 harness 安装原生钩子，--harness codex 可限定范围（codex|hermes|all），--dry-run 预览；--global 是必需的同意标志。其他 hooks 子命令（session-start、inbox-pickup、shepherd-events、memory-recall、capture）由 harness 调用，非手动运行。
撤销与重装：forge reset --soft --force 仅移除 .forge/ 配置（保留命令、规则、代理）；--hard --force 移除所有 Forge 管理文件（保留用户创建文件）；forge reinstall --force 一步完成移除并重跑默认设置。reset 与 reinstall 具破坏性，必须加 --force；reset 不带 --soft/--hard 仅打印用法。
推荐工具：forge recommend 为当前项目建议工具/集成。
边界：切换单个 gate/rail（如 TDD、kernel-tracking）属于 gates，init 只写初始配置；已配置仓库中查询“我在哪/Forge 如何配置”属于 status/kernel；安装项目依赖（bun install）属于 dev。