mcpField
S
setup-env

setup-env

github.com/gitboboboエージェントワークフロー041 回インストール今日更新
リポジトリ

setup-env について

setup-env は、コーディングエージェントの複数のハーネスに共通のグローバルルールを配置し、CLI とローカルツールの状態を確認するスキルです。既存のラッパー設定を保護し、ファイルをバックアップしたうえで、Cargo の sccache 設定も行えます。

主な機能

  1. 01ハーネス間でルールをリンクまたはコピー
  2. 02ルール配置状態と CLI の利用可否を確認
  3. 03cargo-nextest の未導入と PATH の問題を区別
  4. 04Rust ビルドキャッシュに sccache を設定
  5. 05置換前に既存内容をバックアップ

活用シーン

  1. 01複数のエージェント CLI に共通規約を配置
  2. 02グローバルルールと元ファイルの同期を確認
  3. 03エージェント環境での cargo-nextest の可視性を調査
  4. 04ワークツリー間で Rust コンパイルキャッシュを共有

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gitbobobo/skills --skill setup-env

インストール後、Claude Code で/setup-envを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

rules/
AGENTS.md
scripts/
setup-env.mjs
setup-env.test.mjs

詳細

プロジェクトの README より

setup-env

把 rules/AGENTS.md（本技能目录下，唯一真源）链接到各 harness 的全局规则路径，让所有 CLI 代理在任何项目里都加载同一套约定；通用规则涵盖重命令遵守机器调度和单一最终验证负责人，具体编排流程留在对应技能。同步后仍以项目规则优先。同时报告各 harness CLI 与本机工具（如 cargo-nextest）是否可用——工具只报告不安装。cargo-nextest 不在 PATH 时再探测 CARGO_HOME 和默认 Cargo bin，区分「未安装」与「已安装但 PATH 不可见」；后者在实际代理启动环境补路径，再从新代理执行 cargo nextest --version 验证。装了 sccache 时，把它写进 $CARGO_HOME/config.toml 的 [build] rustc-wrapper，让多个工作树共享 Rust 编译缓存（已有别的 wrapper 或设置了 RUSTC_WRAPPER 时不覆盖；改写前先备份原文件）；没装只报告。

步骤

  1. 体检：node <技能目录>/scripts/setup-env.mjs --check，逐项看状态：已链接 / 副本一致 / 副本过期 / 有别的内容 / 缺失。
  2. 执行：node <技能目录>/scripts/setup-env.mjs。Windows 或符号链接权限不足时用 --copy。
  3. 核对备份：脚本对已有非空内容会先备份成 <文件>.bak-<时间戳> 再替换。出现备份就提醒用户检查旧内容是否需要合并。
  4. 完成标准：脚本退出码为 0，且输出中每个 harness 显示「已链接」或「副本一致」。

覆盖的 harness

harnessmacOS / LinuxWindows
devin~/.config/devin/AGENTS.md%APPDATA%\devin\AGENTS.md
codex~/.codex/AGENTS.md~/.codex/AGENTS.md
claude / claudeAgent~/.claude/CLAUDE.md~/.claude/CLAUDE.md
cursor~/.cursor/rules/global.mdc~\.cursor\rules\global.mdc
factory droid~/.factory/AGENTS.md~\.factory\AGENTS.md
pi~/.pi/agent/AGENTS.md~\.pi\agent\AGENTS.md

新增 harness 时改 scripts/setup-env.mjs 里的 TARGETS。pi 的目录可被 PI_CODING_AGENT_DIR 覆盖，脚本也照这个变量取路径。

pi 备注：在 Windows 上，pi 只去 C 盘的 Program Files 找 Git Bash，找不到就用 PATH 上的 System32\bash.exe，也就是 WSL。Git 装在其他盘时，体检会报 pi:shell 待处理，并给出应写进 <agent-dir>/settings.json 的 "shellPath"；照提示写入后重跑体检确认。

Factory Droid 备注：

  • 官方文档确认 ~/.factory/AGENTS.md 是跨项目的个人指令层；Droid 还会检查 ~/.agents/、~/.agent/ 个人目录，本脚本取 ~/.factory 为主落点。
  • 优先级语义：项目 AGENTS.md 优先于个人文件——个人层放与仓库无关的通用约定，不会覆盖项目规则。
  • 逐次调用另可用 droid --append-system-prompt-file <path> 追加提示词（仅当次进程生效，不是持久配置）。

Cursor 备注：

  • cursor-agent 扫描 ~/.cursor/rules/ 的 .mdc 文件；脚本写入带 alwaysApply: true frontmatter 的派生文件（不能符号链接，内容需要包裹），改了 rules/AGENTS.md 后所有机器都要重跑脚本。
  • Cursor 设置 UI 里的 User Rules 存在账号上、由服务端下发（getAllCursorRules），是另一条官方路径，可跨设备同步但只能手动维护，和本文件制互不妨碍。
  • 已知上游怪癖：Agents Window 的 Settings 界面可能不列出 ~/.cursor/rules 下的文件级规则（论坛确认 bug），不影响 agent 运行时加载。

边界

  • 全局规则是「会被加载」，不是「必定遵守」。跨 harness 委派（delegate_task）时的硬性约束仍要原文写进任务 prompt 转述。
  • 仓库级规则仍放各仓库的 AGENTS.md；本文件只放与仓库无关的通用约定。
  • 改约定只改 rules/AGENTS.md。符号链接立即生效；--copy 部署过的机器要重跑本脚本。
  • 本技能只管全局规则和上述 cargo 全局配置，不装 CLI、不改项目。技能本身的安装走 docs/setup.md 的 npx skills 流程。

コメント

Markdown 対応