1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | docs-collaborator（隶属 monday.com 官方技能合集 mondaycom/skills） |
| 作者/维护者 | monday.com（GitHub 认证官方组织） |
| 来源链接 | https://github.com/mondaycom/skills/tree/main/skills/docs-collaborator |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 合集仓库 mondaycom/skills 整体 4★／Forks 0（数据来自 GitHub API；该数字属整个合集，不代表本技能个体热度） |
| 最新版本 | 0.1.0（SKILL.md front matter 标注，仓库未发布独立 GitHub Release） |
| 安装方式 | npx skills add mondaycom/skills --skill docs-collaborator（见第 10 章） |
2. 功能介绍与亮点
docs-collaborator 是 monday.com 官方发布的文档协作技能，负责创建、读取、编辑与评论 monday docs——monday 平台内用于会议纪要、RFC、运行手册、周报、事后复盘等场景的富内容文档。
- 实时字段嵌入：文档内可插入指向看板某条记录某一列的“活”引用，打开文档时始终显示该字段当前值，让静态文档变成随看板联动的仪表盘片段。
- 闭环编辑模式：先读取文档拿到块 ID，再针对块类型匹配正确的编辑操作，避免因跳过读取而写坏文档结构或误改到其他文档的内容块。
- 五套现成文档形态：会议纪要、周报、RFC、运行手册、事后复盘，均给出对应的结构与要点，也支持用户自定义结构的文档。
- 被动/主动两种嵌入模式：默认先用占位标记搭好骨架，只有当用户明确点名具体记录、看板或负责人时才解析真实 ID 并写入实时引用，避免过度自作主张。
- 套餐分级感知：明确提示 Free/Basic 账户最多 3 份文档的上限，并在用户逼近上限时给出提醒而非任其失败。
3. 适用场景
固定分类：集成与工作流自动化
- 需要在 monday.com 内撰写会议纪要、RFC、周报、运行手册或事后复盘、并希望文档内容能实时反映看板真实状态（而非手动复制粘贴过时数字）的团队负责人或运营人员；
- 用自然语言描述需求（“帮我写一份本周更新”）、希望 agent 直接产出结构合理的文档并按需 @ 相关同事的初中级 monday.com 用户；
- 与同合集
board-setup（搭建看板）、project-status-report（生成进度汇报）、task-management（日常任务增删改查）搭配使用，覆盖从建看板到沉淀文档记录的完整链路。
4. 跨 Agent 兼容性
- Claude Code：原生支持——monday.com 官方仓库明确将其列为兼容平台，标准 SKILL.md 格式可直接安装。
- Codex（OpenAI）：原生支持——同一份官方说明明确列出。
- OpenClaw：未验证——官方材料未点名提及，技能本身遵循开放的 Agent Skills 格式（SKILL.md + YAML front matter），理论上可被支持该规范的工具加载，但未见官方或第三方针对 OpenClaw 的验证材料。
- Hermes Agent：未验证——未检索到相关材料。
5. 推荐理由
在 monday.com 里手写文档最容易踩的坑，是内容一旦写下就和看板脱节——负责人换了、状态变了，文档里的数字还停留在写作那一刻。这份技能把“读文档结构 → 匹配正确编辑操作 → 按需嵌入看板实时字段”整理成 agent 可直接执行的闭环流程，还处理了表格/通知框/多栏布局等 monday 文档特有的 API 限制与易错点。整个过程通过 monday.com 官方 Platform MCP 的 OAuth 授权运作，不需要用户手动管理 API Key，对不熟悉 monday 文档模型的初中级用户尤其友好。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | monday.com 为该产品的第一方发布者；所属合集仓库整体仅 4★，第三方装机统计平台 skills.sh 显示该子技能约 23 次安装，暂未检索到独立第三方评测或活跃社区讨论 |
| 可用性 | 7 | 一条 npx 命令即可安装，另需完成 monday.com Platform MCP 的一次性 OAuth 授权；SKILL.md 与独立参考文档内容详尽、含多套可直接套用的文档结构；仓库自 2026-06-02 首次提交后暂无后续更新，维护活跃度证据偏薄弱 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：①Shell 命令执行——不涉及，技能只调用 monday.com Platform MCP 提供的结构化工具（read_docs/update_doc/create_doc 等），不执行系统命令；②联网外发——全部网络交互经由 monday.com 官方 MCP 完成，作用域限定在用户自己授权的 monday.com 工作区内；③凭据处理——通过 OAuth 对接 monday.com Platform MCP，技能本身不要求用户手动配置或存储 API Key；④可疑指令——通读全文未发现提示词注入或未经授权插入无关品牌/产品的内容；⑤作者信誉——GitHub 认证官方组织 monday.com，无造假迹象；⑥License——MIT，明确；⑦维护时间——仓库最近一次提交为 2026-06-02，距今约 2.5 个月，暂无后续迭代记录。
综合评分（三项均值）：7.67
7. 跟同类 Skills 相比的优势
| 同类方案 | 定位 | 与本 skill 的差异 |
|---|---|---|
doc-coauthoring-anthropics-skills（Anthropic 官方出品） |
通用文档协同撰写技能，聚焦人机协作改稿的编辑流程 | 面向任意文档载体的通用协作范式；本技能专注 monday.com 平台文档，内置该平台专属的块类型路由规则与实时看板字段嵌入能力 |
notion-openai-plugins（Notion 官方出品） |
把 Notion 的页面、数据库操作开放给 agent，覆盖笔记、任务、知识库等通用场景 | 面向 Notion 灵活的通用页面/数据库模型；本技能专注 monday.com 文档这一单一场景，换取更深的平台特定知识（如闭环编辑、活字段嵌入） |
同合集内 project-status-report |
从看板数据自动生成结构化进度汇报，产出物固定为报告 | 处理的是“数据 → 报告”的单向生成；本技能处理任意文档形态的创建、读取、编辑与评论全生命周期，两者可组合使用 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；所属仓库 GitHub Issues 中暂无与本技能相关的独立讨论。
9. 其他补充
docs-collaborator 是 monday.com 官方 mondaycom/skills 合集中的 5 个技能之一（另有 board-setup、task-management、forms-builder、project-status-report），既可单独安装，也可用 npx skills add mondaycom/skills 一次装全套。monday.com 官方仓库同时将其列为可被 Claude Code、Cursor、OpenCode、OpenAI Codex 等遵循 Agent Skills 标准的工具使用。
10. 安装使用方式
通用方式（Claude Code / Codex 等支持 Agent Skills 标准的工具）：
npx skills add mondaycom/skills --skill docs-collaborator或一次性安装 monday.com 全部 5 个官方技能：
npx skills add mondaycom/skills安装后注意事项：首次使用时需完成 monday.com Platform MCP（https://mcp.monday.com/mcp）的 OAuth 授权登录，无需手动申请或粘贴 API Key；需要在目标 monday.com 工作区中拥有对应文档的读写权限；无需重启 agent，安装完成后下一轮对话即可触发（如“帮我写一份本周更新纪要”）。
11. 注意事项
- 仓库自 2026-06-02 首次提交后暂无功能性更新，属早期发布阶段，长期维护走向有待观察；
- 表格、多栏布局（layout）等块类型创建后无法通过 API 直接填充单元格内容，需要用户回到 monday 界面手动补全，或改用 Markdown 一次性重建；
- Free/Basic 套餐账户最多创建 3 份文档，技能会在接近上限时提示但不能替用户升级套餐；
- 依赖 monday.com Platform MCP 服务可用性，若该服务临时不可访问，技能将无法执行读写操作。