1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | basecamp-basecamp-basecamp-cli | 见下方命名说明 |
| 项目自述名称 | SKILL.md 内 name: basecamp;所属仓库标题为「Basecamp CLI」 |
SKILL.md + README |
| 作者/维护者 | 37signals(Basecamp 官方 GitHub 组织 basecamp) |
GitHub API + plugin.json |
| 来源链接 | https://github.com/basecamp/basecamp-cli/tree/main/skills/basecamp | — |
| 许可证 | MIT | plugin.json + 仓库 LICENSE |
| GitHub Stars / Forks | 239 / 18(整仓库;CLI 与技能同源同批分发) | GitHub API |
| 最新版本 | v0.8.0(2026-08-03 发布) | GitHub Releases |
| 安装方式 | 见第 10 章 | 仓库 README |
2. 功能介绍与亮点
basecamp 是 Basecamp 官方 CLI 随附的 agent skill,教会编程 agent 通过官方命令行工具操作 Basecamp 全部 155 个 API 端点:项目、待办、看板卡片、消息、聊天、文件、日程、check-in、时间线、模板、webhook、通知、账户等一应俱全。亮点:
- agent 原生输出:
--agent/--json/--jq/--md多种输出模式;--agent --help可结构化自省任意子命令的用法与参数,agent 不必凭记忆瞎猜 - OAuth 自动续期:登录凭据由操作系统原生密钥库(Keychain / Credential Manager / Secret Service)托管;无密钥库环境时降级为 0600 权限的本地文件
- 配套诊断技能:随附 basecamp-doctor,一键体检 CLI、认证状态与 agent 插件安装情况并给出修复命令
- 官方设有专属落地页 basecamp.com/agents,明确将其定位为「面向 AI agent 的官方一等公民」
3. 适用场景
所属分类:集成与工作流自动化。适合已用 Basecamp 管理项目的团队、自由职业者与代理机构——把日常待办创建、进度跟进、check-in 回复、文档撰写这类操作交给 AI agent 在终端或编码会话里直接完成,不必来回切换浏览器标签页。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持——仓库自带
.claude-plugin/plugin.json,执行basecamp setup claude一键安装插件、技能与启动钩子 - Codex:✅ 原生支持——仓库自带
.codex-plugin,执行basecamp setup codex一键安装 - OpenClaw:❓ 未验证——官方页面泛称「支持任何能执行 shell 命令的 agent」,未见具名验证
- Hermes Agent:❓ 未验证——理由同上
5. 推荐理由
官方一手出品、文档详尽到可供 agent 结构化自省、凭据管理经过明确的操作系统级加固设计,且产品仍在每日更新——是「把 SaaS 项目管理工具交给 agent 打理」这条赛道里少有的、由厂商自己下场维护的原生 skill。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 官方一线厂商(37signals)出品,设专属落地页 basecamp.com/agents,并被 LobeHub、mcpmarket、claudemarketplaces 等第三方技能市场列入目录;但产品仅上线约 7 个月,GitHub 239★ 仍属早期阶段 |
| 可用性 | 9 | 一条命令安装,另提供 brew/scoop/apt/dnf/apk/nix/go install 等 7 种途径;1198 行 SKILL.md 含结构化自省与诊断工具;实测当日仍有提交与新版本发布 |
| 安全性 | 9 | 见下方检查清单,逐项通过且明显优于地板要求 |
安全检查清单:
① shell 命令及权限:仅执行 basecamp 官方 CLI 子命令,不涉及任意 shell,范围可解释
② 联网外发:仅联向 Basecamp 自身 API(3.basecamp.com / basecampapi.com),用途透明
③ 凭据存储:OAuth token 由操作系统原生密钥库管理,无密钥库环境降级为 0600 权限本地文件;SKILL.md 明确指示 agent 不得读取或打印凭据文件
④ 可疑指令:未发现;反而包含防范克隆仓库配置劫持 OAuth token 的显式保护逻辑
⑤ 作者信誉:37signals(Basecamp / HEY / Rails 生态知名厂商),无造假迹象
⑥ License:MIT,清晰
⑦ 维护时间:实测 2026-08-03 当日仍有提交与新版本发布
7. 跟同类 Skills 相比的优势
| 维度 | basecamp(本技能) | notion-cli(Notion 官方) | linear(OpenAI 官方插件) |
|---|---|---|---|
| 服务对象 | 项目管理/待办协作(Basecamp) | 知识库/文档(Notion) | issue 追踪(Linear) |
| 分发形态 | 独立 CLI 二进制 + 原生 skill,7 种包管理器可选 | npm CLI(ntn)+ skill |
OpenAI 插件市场,需在 Codex 内启用 |
| 凭据管理 | OS 原生密钥库托管,附带专门诊断技能 | 未见同等系统级密钥库集成说明 | OAuth 连接工作区 |
| API 覆盖面 | 155 个端点,项目管理全流程 | 页面/文件读写,另支持自定义 Workers 代码部署 | issue/项目/文档读写 |
三者服务的 SaaS 不同,但模式相近(官方 CLI + skill 包装);basecamp 在凭据安全工程与 agent 自省能力上着墨最多。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价;LobeHub、mcpmarket、claudemarketplaces 等第三方技能市场已将其列入目录,但均为目录列表,未附用户评论。
9. 其他补充
仓库同时维护 basecamp-doctor 诊断技能,一键排查 CLI、认证与 agent 插件安装状态并给出修复命令。37signals 另有 basecamp/claude-plugins 仓库覆盖 HEY、Fizzy 等自家产品的 Claude 插件,可能是该团队 agent 集成路线的后续扩展方向。
10. 安装使用方式
- macOS / Linux / WSL2:
curl -fsSL https://basecamp.com/install-cli | bash - Windows PowerShell:
irm https://raw.githubusercontent.com/basecamp/basecamp-cli/main/scripts/install.ps1 | iex - 其他途径:brew / scoop / apt / dnf / apk / nix / go install 均支持,详见仓库 README
- 安装后执行
basecamp auth login完成 OAuth 授权,再执行basecamp setup claude(或setup codex)安装对应 agent 的插件与 skill;随时可用basecamp doctor --json自检环境是否就绪
11. 注意事项
- 需要一个可用的 Basecamp 账号/工作区(试用版即可体验,正式使用视 Basecamp 自身订阅方案)
- 目前仅明确验证 Claude Code 与 Codex 两个生态原生支持,OpenClaw / Hermes Agent 暂未见具名验证
- 产品上线约 7 个月,处于官方所述面向早期用户的技术预览阶段,后续 CLI 命令与输出格式可能调整