用途：在安装共享 agent skills 的宿主仓库中运行，检测仓库事实并映射到每个已安装技能的 config.json，生成准确配置，同时维护根目录 .gitignore 与 .claude/skills.lock 清单。
主要能力：按配置键名（而非技能）检测，如 baseBranch、issueKeys；对每个键做三方比较，分为 inferred（写入检测值）、unchanged（无操作）、drift（保留人工值并报告）、needs-manual-input（留待人工补充）、manual-kept、unknown-kept。可追加 .gitignore 忽略 preflight 的 .preflight-summary.json，并移除消费者仓库中错误的 skills config 忽略规则。生成含 source、ref 与各技能版本的 skills.lock。
使用方式：默认试运行 node <skills-dir>/initialise-skills/scripts/initialise.mjs --dry-run --json；确认后以 --write 写入，可通过 stdin 传入 facts 与 acceptDrift；--review 只读查看完整配置；--set <skill>.<key>=<value> 写入任意值，键须存在于该技能 config.example.json 且类型匹配；另有 --json、--repo-root、--skills-dir。
适用场景：多技能共享配置的仓库初始化与后续校准，检查哪些仓库落后于技能版本。
限制：preflight 被有意跳过；多 bundle 仓库的 send-it.bundleVersioning 需手工添加；Linear 相关键无 MCP 时需人工提供；GitHub App 与 CLAUDE_CODE_OAUTH_TOKEN 仅能尽力探测，无法验证时不阻断。