mcpField
B
basecamp-doctor

basecamp-doctor

github.com/basecamp开发84286 次安装今天更新
代码仓库

关于 basecamp-doctor

用于 Basecamp CLI 及其 Agent 集成的诊断技能，可解读结构化检查结果和修复提示，并根据身份验证类型指导后续操作。

主要功能

  1. 01解读结构化诊断结果
  2. 02报告失败项与警告项
  3. 03处理 breadcrumbs 后续步骤
  4. 04按身份验证类型提供修复建议
  5. 05指导 Agent 集成设置

适用场景

  1. 01诊断 Basecamp CLI 配置
  2. 02检查失败或警告项
  3. 03为 Agent 配置选择修复方式
  4. 04检查 Agent 插件安装情况

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/basecamp/skills --skill basecamp-doctor

安装后在 Claude Code 中输入/basecamp-doctor确认已加载。

详细介绍

Basecamp Doctor

运行结构化诊断：

basecamp doctor --json

根据状态解读每项检查：

  • pass：运行正常。
  • warn：可以使用，但建议后续处理。
  • skip：因未通过身份验证或不适用而未运行。
  • fail：已损坏，需要处理。

报告失败和警告，并附上其 hint 字段。还要检查顶层的 breadcrumbs 数组，并保留其中结构化的 cmd 后续步骤，因为面包屑可能会提供比检查提示更具体的操作。在适用时使用以下常见修复方法：

  • Basecamp 身份验证：basecamp auth login。使用 --expect-identity <id> 限定替换登录，避免已在浏览器中登录的其他用户成为该配置文件。必须永不交互式登录的机器人或 CI 配置文件应改为导入个人访问令牌： op read "op://<vault>/<item>/credential" | basecamp auth login --with-token -P <profile> --account <id> --expect-identity <id>

    在建议上述任一方法前，先检查 oauth_type。 basecamp auth status --json 会报告该值；agent 表示此配置文件是 Basecamp Agent：一种背后没有个人的主体，它使用自己的 OAuth 客户端进行身份验证，而非通过登录进行身份验证。上述两个命令都会将某个人的凭据存入该配置文件，并静默替换 Agent。它的修复方法是使用自己的登录方式，并通过管道传入客户端密钥： op read "op://<vault>/<item>/credential" | basecamp auth login --with-client-credentials --client-id <id> -P <profile> --account <id> CLI 针对 Agent 凭据给出的 hint 已包含此命令，并填入了客户端 ID——应优先原样使用，而不是自行重构；只要 oauth_type 缺失，就应遵循该提示，而不要自行选择。

  • Agent 插件安装或版本：basecamp setup agents（遵循 BASECAMP_SETUP_AGENT）

  • Codex 专用插件：basecamp setup codex

  • Claude Code 专用插件：basecamp setup claude

  • Grok 专用技能：basecamp setup grok（仅限技能；Grok 会读取共享的 ~/.agents/skills/basecamp 技能）

以上每种修复方法都可以在没有终端的情况下运行。单独运行 basecamp setup 是面向用户的首次设置流程，不属于上述修复方法：它会打开浏览器 OAuth；在机器输出模式下，或 stdin、stdout 和 stderr 未全部连接到终端时，它会因用法错误而拒绝运行。basecamp setup --customize 还会要求用户选择每项默认设置。如果有帮助，可以建议终端前的用户使用这两种方式，但切勿自行运行——请改用上述子命令。

不要读取、打印或索取凭据文件。如果所有检查都通过，请说明 Basecamp 及其 Agent 集成已准备就绪。

评论

支持 Markdown