mcpField
D
dosu

dosu

github.com/dosu-aiAgent 工作流1424 次安装5 周前更新
代码仓库

关于 dosu

Dosu 是用于操作 Dosu 平台的命令行技能,涵盖 Library、Agent、文档及相关流程。它强调结构化输出、按产品要求满足前置条件,并为变更设置安全边界。

主要功能

  1. 01命令行登录与设置指引
  2. 02管理 Library、数据源和 Agent
  3. 03搜索知识并读取文档
  4. 04创建、导入和发布文档
  5. 05审核与变更安全流程

适用场景

  1. 01从现有数据源搭建 Dosu Library
  2. 02查找文档并生成综合答案
  3. 03配置 Agent 或查看对话
  4. 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.md
audit.md
commands.md
review-workflow.md
workflows.md

详细介绍

使用 Dosu CLI

通过 dosu 操作 Dosu。优先使用结构化输出,并让 CLI 和 App 验证产品规则。

正确开始

  1. 运行 dosu --version。不要使用无关的软件包管理器命令探测是否已安装。
  2. 如果该命令不可用且已安装 Node,请尝试 npx -y @dosu/cli --version,并在本次会话中使用 npx -y @dosu/cli 作为命令前缀。否则,请先征求同意,再安装任何内容。
  3. 使用命令参考中未涵盖的命令之前,先运行 dosu --help 或相关的嵌套 --help。参见命令参考。
  4. 只要该叶子命令提供 --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 中的引导式入门流程;该流程按检查点推进——先询问、等待,然后再操作
创建或配置 Librarydosu libraries ...
附加现有组织数据源dosu sources list → dosu libraries sources attach
创建或配置 Agentdosu 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 或后端错误表示操作失败。请说明代码、路径和状态,不要暗示所请求的状态已存在。

参考资料

评论

支持 Markdown