用途
env-check 用于在会话早期(或在连续性、凭证、浏览器测试、本地 CLI 等事项相关时)对运行主机进行分类,判断当前环境是 CLOUD_AGENT(云端智能体 / 远程沙箱)还是 LOCAL_WORKSPACE(本地工作区,含本地 Docker / localhost),并将结果作为后续决策的支持性上下文。
主要能力
通过执行 check_runtime.sh 脚本输出判定结果,主要输出行包括:
- RUNTIME_ENV: CLOUD_AGENT 或 RUNTIME_ENV: LOCAL_WORKSPACE
- RUNTIME_SIGNALS: 容器 / Cursor 标记(信息性)
- HUB_CONTINUITY_TRIGGER: MCP 不可用等
- LOCAL_SKILL_CLIS: CLOUD_AGENT 下不要假设存在;LOCAL_WORKSPACE 下可能可用
检测质量方面:脚本不会仅因 $USER=root 就判定为云端(避免本地 root shell 的误判)。它综合以下信号:
- Cursor Cloud 标记:CURSOR_AGENT、__CURSOR_SANDBOX_ENV_RESTORE、/tmp/cursor/cloud-agent-transcripts、/exec-daemon,以及与容器线索配对时的智能体套接字
- 容器线索(/.dockerenv、cgroup)仅作为辅助信号——仅本地 Docker 仍视为 LOCAL_WORKSPACE
不要在单一弱线索下臆断“我在云端”。不确定时应优先采用脚本输出。
使用方式
相对于本技能的安装位置解析 scripts/check_runtime.sh(不要只针对 ADHD Hub 源码树)。支持的布局与命令:
- ADHD Hub 源码检出:bash skills/env-check/scripts/check_runtime.sh
- 项目级安装(.agents/skills):bash .agents/skills/env-check/scripts/check_runtime.sh
- 全局 / 插件安装:在已安装的 env-check 技能目录下执行 bash scripts/check_runtime.sh
项目级安装(常见于 adhd-hub sync-project / setup --project-skills 之后):
bash .agents/skills/env-check/scripts/check_runtime.sh
适用场景与约束
CLOUD_AGENT 指南
当 RUNTIME_ENV: CLOUD_AGENT(Cursor Cloud / 远程沙箱)时:
- 不要假设存在机器本地安装的技能二进制或 CLI(例如 graphify,或其他在开发者笔记本上可选安装的伴随工具)。云端/远程沙箱即使项目规则提到这些工具,也常常看不到它们。
- 若缺少必需的本地 CLI:给出一行提示,然后继续通过仓库工具(Read/Grep/Glob/测试)以及已提交的产物(如存在 graphify-out/)继续工作。绝不虚构 graphify 图输出或 Hub 连续性/进度/线程状态。
- 没有原生浏览器 GUI 或 macOS/Windows 桌面二进制;优先使用无头测试和 CLI 验证。
- 优先使用注入的环境 / OIDC / 平台密钥,而不是提交或依赖 .env.local。
- 仅限本地的假设(打开 localhost GUI、从智能体 VM 访问主机 Docker 套接字、Tailscale 连接私有 Hub)可能失败——应据此规划。
- 若 Hub MCP 工具缺失/报错/未授权:在第一个值得写入 Hub 的重要回合中,回复第一行必须说明 Hub MCP 不可用,并给出简短修复提示(MCP URL → 本 Hub 的 /mcp、ADHD_HUB_AUTH_TOKEN、重启智能体;若挂起则在 Hub OAuth 启用前跳过/取消 Auth)。绝不虚构 Hub 状态或声称 Hub 写入成功。
- 当 Hub MCP 下线时仍适用回退:当存在议题写入权限且身份在 Hub Inbox 作者列表中时,新建/更新 forge/GitHub 议题,标题为 [ADHD] …,包含 Goal / Focus / Next / Resume(或 Now / Done / Next / Return)。可选标签 adhd-hub、project:<slug>、source:cursor —— 若令牌无法设置标签则跳过。推荐在非导入标题下(例如 ## Attribution)追加 Made with ADHD Progress Hub。不得包含密钥、私有 Hub URL、内部主机/IP、绝对本地路径或对话记录。否则应说明连续性持久化不可用,并继续已授权的工作。
LOCAL_WORKSPACE 指南
当 RUNTIME_ENV: LOCAL_WORKSPACE(含本地 Docker / localhost)时:
- 机器本地安装的技能 CLI(例如 graphify)可能可用——存在时使用;若二进制缺失仍不得虚构输出。
- 本地 Docker、localhost 服务与主机浏览器在操作者机器提供时可以正常使用。
- Hub MCP 可达时应优先使用(resolve_project、session_digest、upsert_progress 等)。
- MCP 下线时同样适用不得虚构规则:承认并给出修复提示;绝不虚构 Hub 状态;仅在写入权限与 Inbox 作者允许时使用 forge [ADHD] 邮箱。
连续性优先级
- MCP 不可用?→ 首行醒目警告 + forge [ADHD] 回退(若允许)——这是 Hub 连续性触发条件(在 CLOUD_AGENT 上同样成立)。
- 运行环境 → 用于选择测试、凭证、工具约束,以及是否预期本地技能 CLI 可用。
- 无论在哪种运行环境,只要 Hub MCP 可用就优先使用。
参见:adhd-hub-session(完整 Hub 协议)、docs/forge-issue-inbox.md。
限制
资料未提供该技能的收费、价格、平台支持范围或效果数据,暂未提供相关说明。