关于 dosu
Dosu 是用于操作 Dosu 平台的命令行技能,涵盖 Library、Agent、文档及相关流程。它强调结构化输出、按产品要求满足前置条件,并为变更设置安全边界。
主要功能
- 01命令行登录与设置指引
- 02管理 Library、数据源和 Agent
- 03搜索知识并读取文档
- 04创建、导入和发布文档
- 05审核与变更安全流程
适用场景
- 01从现有数据源搭建 Dosu Library
- 02查找文档并生成综合答案
- 03配置 Agent 或查看对话
- 04应用前审核文档变更
MCP 相关
该技能说明如何通过 `dosu deployments` 选择和管理 MCP 部署;这些命令与 Agent 管理相互独立。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ dosu-ai/ dosu-skill --skill dosu安装后在 Claude Code 中输入/dosu确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/audit-findings-schema.mdaudit.mdcommands.mdreview-workflow.mdworkflows.md详细介绍
使用 Dosu CLI
通过 dosu 操作 Dosu。优先使用结构化输出,并让 CLI 和 App 验证产品规则。
正确开始
- 运行
dosu --version。不要使用无关的软件包管理器命令探测是否已安装。 - 如果该命令不可用且已安装 Node,请尝试
npx -y @dosu/cli --version,并在本次会话中使用npx -y @dosu/cli作为命令前缀。否则,请先征求同意,再安装任何内容。 - 使用命令参考中未涵盖的命令之前,先运行
dosu --help或相关的嵌套--help。参见命令参考。 - 只要该叶子命令提供
--json,就传入该参数。解析结果;不要抓取人类可读的表格。
满足正确的前置条件
dosu login提供供基于 tRPC 的命令使用的 JWT。dosu setup会选择组织、Library 上下文和 MCP 部署,创建 API 密钥,并可配置 Agent 工具。dosu ask需要 API 密钥。docs generate、docs auto-tag和docs publish同时需要 JWT 登录和 API 密钥。其他平台命令通常需要 JWT 登录;限定于某个组织或当前 Library 的命令还需要选择相应的上下文。- 配置编码 Agent 时,请遵循 workflows.md 中不会阻塞的
dosu setup --agent --tool <id>工作流。转发其 URL 并执行返回的resume_command;绝不要臆造工单命令。
使用当前产品术语
- Organization 是账户和权限边界。
- Library 是 App 中显示的知识容器。较旧的 API 可能称其为
space;不要向用户提及这个内部名称。 - Data source 是组织级连接,例如代码仓库、Slack 频道或 Notion 工作区。Library 可以使用已连接的数据源。
- Agent 是可配置的 GitHub、GitLab、Slack 或 Teams 部署,且只服务于一个 Library。
- Monitor 按 Library 和数据源设置,支持 GitHub、GitLab 和 Azure DevOps 数据源。
dosu deployments用于管理可选择的 MCP deployments。不要将其用作 Agent CRUD 命令。
按意图选择路径
| 意图 | 路径 |
|---|---|
| 端到端设置 Dosu(“set up dosu”、从头创建新的 Library) | 先阅读 workflows.md 中的引导式入门流程;该流程按检查点推进——先询问、等待,然后再操作 |
| 创建或配置 Library | dosu libraries ... |
| 附加现有组织数据源 | dosu sources list → dosu libraries sources attach |
| 创建或配置 Agent | dosu agents ... |
| 获取综合回答 | dosu ask |
| 查找源文档 | dosu knowledge search,然后运行 dosu docs get |
| 创建、导入或发布文档 | dosu docs ... |
| 审查待处理的文档更改或回复草稿 | 先阅读 review-workflow.md |
| 检查对话 | dosu threads ... |
| 浏览托管主题 | dosu topics ... |
| 审查 Agent 文档、README、架构或依赖项 | 先阅读 audit.md |
将 commands.md 作为唯一的详细命令和标志参考。仅在组合多个命令时使用 workflows.md。
应用 Library 和 Agent 语义
- 要组装 Library,请列出组织来源、创建 Library、附加所选来源 ID,然后使用
libraries info和libraries sources list验证。CLI 无法建立全新的 OAuth 连接。 libraries sources config会在 App 端解析提供方。选择提供方专属选项前,请先阅读命令参考。- 使用 GitHub 仓库创建 Library,或将其新附加到现有 Library 时,除非用户选择退出,否则应将 Monitor 作为设置的一部分。使用整个仓库和
emoji默认值启用它,并进行验证,同时说明 Monitor 会审核拉取请求,以保持 Library 知识的最新状态。遵循 Library 工作流;不要询问用户是否选择默认值。 - 使用现有来源 ID 创建 Agent,并让 App 选择默认值;不要在 shell 命令中自行编造配置。每个数据源最多只能支持一个 Agent:如果
agents create返回CONFLICT(409),表示该来源已有 Agent——请提供其他来源,或改为执行经过授权的agents move,不要重试。 - 修改现有配置中的单个叶节点前,请先读取 Agent 配置。值为 JSON。如果并发写入返回
CONFLICT,请重新读取、重新评估所请求的更改,并且仅在更改仍正确时重试。 - 移动 Agent 会替换其 Library。请验证返回的
space_id;不要根据移动回执推断历史数据的迁移行为。
遵守写入边界
- 将用户明确、无歧义地请求执行的确切变更视为授权。否则,请展示计划的变更并等待确认。
- 对于提供
--confirm的命令,如果预览有帮助,请先省略该参数;{ "confirmRequired": true, "applied": false }表示没有任何更改。仅在获得授权后才传入--confirm。 - 切勿批量批准或拒绝审核项。逐项比较差异、说明内容,并且只处理用户授权的 ID。
- 删除 Library、Agent、来源或文档前,请说明确切目标及影响。分离来源前,请读取并说明命令参考中记录的影响。某些较早版本的删除命令不会强制要求
--confirm;CLI 未提示确认不代表用户已批准。 - 将来源附加到公开 Library 前,请提醒用户,其内容将对所有有权访问该 Library 的人开放。
- OAuth 连接和计费只能通过 Web 操作。请说明这一限制,不要声称操作成功。
按实际情况处理失败
Not logged in或无法恢复的会话过期:运行dosu login(Agent 设置也可能返回工单流程)。- 缺少组织、Library、部署或 API 密钥上下文:运行相应的
dosu setup流程。 confirmRequired:未发生写入。- 配置发生
CONFLICT:重试前重新读取。 - tRPC 或后端错误表示操作失败。请说明代码、路径和状态,不要暗示所请求的状态已存在。
参考资料
- commands.md:权威的 CLI 语法、选项、默认值、冲突和前置条件
- workflows.md:可复用的多命令流程
- review-workflow.md:审核安全性和上下文
- audit.md:仓库审计流程
- audit-findings-schema.md:
.dosu/audit.json规范
评论
支持 Markdown