用途:swain-init 是 swain 的项目引导与会话入口技能,用于在项目中一次性接入 swain。资料明确说明该技能非幂等(会迁移文件、安装工具),会话级健康检查应改用 swain-doctor。
主要能力:先运行预检脚本收集环境状态,并将结果存入 PREFLIGHT_JSON 供后续所有阶段引用,避免重复执行检查命令。
Phase 0 已初始化检测:依据 marker.action 分支——delegate(同主版本,提示已初始化并转交 swain-session,跳到 Phase 7)、upgrade(有新主版本,提示可运行 /swain update,跳 Phase 7,不重跑入职)、onboard(无标记,执行完整 Phase 1–6)。
Phase 1 文件迁移:按 migration.state 处理 CLAUDE.md → AGENTS.md,建立 @AGENTS.md 引用模式;fresh 建两个文件,standard 复制内容并保留说明,split 时询问用户合并/保留/中止。
Phase 2 依赖校验:检查 uv(缺失则用 curl -LsSf https://astral.sh/uv/install.sh | sh 安装)、内置 tk 是否健康、可选从 beads 迁移任务(转换为 .tickets/ 的 markdown)、创建 operator bin/ 符号链接。
Phase 3 提交前安全钩子:检查或创建 .pre-commit-config.yaml,默认启用 gitleaks,可选 TruffleHog、Trivy、OSV-Scanner;若缺 pre-commit 框架则用 uv tool install pre-commit 安装,随后运行 pre-commit install,并更新 swain.settings.json 的 sync.scanners。
Phase 4 与 4.5:可选安装 obra/superpowers(npx skills add obra/superpowers)、tmux(brew install tmux)及 shell 启动器(支持 zsh、bash、fish;Crush 为部分支持,不能接受初始提示)。
Phase 5 治理:征得同意后将治理规则注入 AGENTS.md,路由工件请求、任务跟踪并强制先计划后实现。Phase 5.5 生成 README 并按需提议 Vision、Personas、Journeys、Designs 种子工件。Phase 6 创建 .agents 目录并引导 .agents/bin/。
限制与缺失:资料原文在 Phase 6.1.1 处截断,后续步骤未提供;未提供收费、价格、适用平台等事实,暂未提供。缺少 uv 时脚本将无法运行,但初始化不会被阻塞。