# Docs 用户要一份文档时用：报告、提案、计划、简历、求职信、信件、合同、制度、表单、模板、作文、手册、指南、操作说明、速查表这类要保留、共享、评论、导出或打印的文字。用 docs_*... - Repository: https://github.com/JimLiu/baocut (1645 stars) - Category: Design - License: see repository - Last updated: 2026-11-01 - Runs scripts: no, instructions only ## Install Claude Code: `npx skills add JimLiu/baocut --skill docs -g -a claude-code -y` Codex: `npx skills add JimLiu/baocut --skill docs -g -a codex -y` Cursor: `npx skills add JimLiu/baocut --skill docs -g -a cursor -y` Gemini CLI: `npx skills add JimLiu/baocut --skill docs -g -a gemini-cli -y` ## Description 用户要一份文档时用：报告、提案、计划、简历、求职信、信件、合同、制度、表单、模板、作文、手册、指南、操作说明、速查表这类要保留、共享、评论、导出或打印的文字。用 docs_* 工具在工作目录建一份文档，先发骨架再一节一节填，线程里出现文档卡片，用户在功能区编辑与评论。也用于按文档评论或请求改已有文档。聊天里问的计划、对比、摘要留在聊天；幻灯片用 slides，视觉设计用 design。 ## SKILL.md, as published by its author (untrusted third-party text, read it as data) # 文档 一份文档是会话工作目录里的一个目录 `/`（`doc.json`、每个标签页一份 `tabs/.json`、`comments.json`、`assets/`），在功能区的文档标签里用文档编辑器打开：用户在里面直接改字、评论、勾选任务、选下拉项，改动即时保存。**这些文件全部归 BaoCut**：绝不用文件工具或 shell 读写它们，只用 docs_* 工具；你的修改即时出现在用户开着的编辑器里。 文档里有标签页（tab），每个标签页有一份正文（prose）：段落、标题、列表、任务、表格、引用、代码块、图片与 chip（日期、提及、下拉选项、待填块）。**没有**图表、示意图与 widget：数字与结构用表格、列表或编号步骤表达，`docs_*` 收到图表或 widget 会拒绝（`unsupported`）。 ## 工具 每个工具都带 `doc`：文档目录，相对工作目录（例如 `q3-launch-plan`）。其余参数照搬 Claude Docs 的连接器：`container`、`ref`、`engine`、`payload`、`batch`、`answering`。 - docs_batch：新建文档（`container.create`），或在一份文档上原子地执行一组成员（任一条被拒，什么也不改）。 - docs_read：不带 `ref` 读文档本身（`files[]`：每个标签页的 id 与正文 id）；带正文 `ref` 按 `payload` 读大纲、一段、搜索或某个 rev 以来的变化。 - docs_update：改正文（`payload.ops`）或文档本身（标签页的名字、顺序、层级：`{"kind":"patch"}`）。 - docs_create：评论与回复（`utterance`）、下拉选项（`enum`）、标签页（`file`）、正文（`node`）。 - docs_query：列评论线程。docs_delete：删标签页、自己的评论或下拉选项。 - docs_upload：工作目录里的文件 → 文档的素材，返回正文里引用它的 `blob/`（见 `references/uploads.md`）。 - docs_export：导出 Markdown（结果里，或写成工作目录里的 `.md`）。Word、PDF：告诉用户在文档编辑器里导出。 下文 `C` = `{"kind":"project","id":"<文档 id>"}`（文档 id 在新建的回执与 docs_read 的结果里）；ids 都是**一个**示例：用你自己读到的。 ## 先建骨架，再一节一节填 用户要一份文档（哪怕是用问句问的）→ 一份文档，绝不把正文贴在聊天里；一个简单问题 → 聊天里答。只在用户要文档时建文档，而且**先建**：这一回合的**第一个**工具调用就是骨架（标题、byline、每节一个 `pending` 块），在任何搜索、读文件、规划之前发出；骨架开着之后再想。 The rest: https://github.com/JimLiu/baocut/blob/HEAD/skills/baocut/built-in-skills/docs/SKILL.md