SuperAPI AI 工具集

wt-config

通用与其它

查看项目

更新于 10-15 22:14

技能介绍

用途:针对具体仓库检查项目事实,推荐最小可用的 wt 活跃配置,并诊断已有配置与意图、实际解析结果之间的偏差。它不是 wt setup CLI,也不负责启动工作、协调智能体、落地分支或清理工作树。

主要能力:判断配置应归属哪个文件(共享 .wt.toml、个人 <repo-root>/.wt/config/local.toml、命名 profile);推荐活跃 TOML 而非注释教程;说明各配置段保留、添加、修改或省略的理由;检查本地缺失工具;给出环境变量模板替换建议;提供验证命令。

使用方式:先运行 git rev-parse --path-format=absolute --show-toplevel、查找 .wt.toml/config.toml/profile.toml、wt config show、wt doctor,并用 rg 扫描清单与 CI 文件;再读取相关清单、文档与 CI,检查工具可用性。环境/密钥引导只查看文件名与命令可用性,绝不读取或打印 .env 等密钥内容。

配置归属:个人仓库配置、本地路径、本地智能体命令、私有运行时细节放 <repo-root>/.wt/config/local.toml;团队共享的项目集成配置放 .wt.toml;仅当可复用结构化 profile 值得额外文件时才用 profiles/<name>/profile.toml。不要把 .wt 或链接工作树的 .wt 符号链接放入 [worktree].link。

推荐规则:仅在需要可重复 cmux 标签时保留 [workspace];仅当存在真实每工作树安装/同步步骤时加 [setup];[setup.env] 与 [setup.env_files] 仅用于非密钥、工作树专属值,且目标文件须在 copy/link/copy_as 后已存在;[issues] 仅在用 provider issue 工作流时加;[site]、[workspace.browser]、workspace.post_deps_tabs 仅用于有本地服务器或 URL 的应用/网页仓库;[workspace.browser.chrome_devtools] 仅在 mode = "chrome_devtools" 时加;[editor] 仅推荐一个活跃命令;[worktree] 仅用于真实路径/复制/链接/上下文需求;[workflow] 仅在策略需偏离内置默认时加。工具未安装时不要加入 cargo-audit、cargo-deny、浏览器或 provider 辅助。

环境模板:实现模块为 env_template,但活跃配置面是 [setup.env] 与 [setup.env_files."relative/path"],不要推荐 env_template 字段或段。根 [setup.env] 只用于 <worktree>/.env;嵌套或带后缀文件用 [setup.env_files."path"]。值由 setup 变量渲染,如 {{site_url}}、{{api_url}}、{{vite_port}}、{{api_port}}、{{branch_slug}}、{{worktree_path}}、{{worktree_name}}、{{issue_title}}、{{wt_agent_id}};{{site_name}} 仅在配置 site 时存在,Chrome 调试变量仅在 Chrome DevTools 浏览器设置激活时存在。未知变量保持可见,不要编造值。

诊断:对照文件声明、wt config show 实际解析与用户意图三者。常见偏差包括 profile 休眠、命名 profile 与内联 [profile.agent.*] 冲突、scaffold 漂移、prompt 文件与内联冲突、环境模板空操作或目标错误。合并语义以 docs/consistency.md 的 Config Merge Semantics 为准。

验证:推荐或编辑后运行 wt config show 与 wt doctor;涉及命名 profile 时运行 wt config show --profile <name> 及 wt config show | grep -E 'copy_as|[agent'。

限制:资料未提供收费、价格、平台支持范围等信息;不得将环境模板用作密钥引导或文件创建;缺失环境目标会被跳过。