outline-skill 是一款专为 AI 编程智能体打造的开源 Skill 与 CLI 工具，能让 Claude Code、Cursor、Google Antigravity、Codex 等 AI 编程助手直接读写、检索和排版 Outline 知识库——会话里产生的排障记录、架构决策、技术方案，不再烂在终端历史里，而是被自动沉淀成格式规范的团队文档。
痛点：高价值知识都烂在终端历史里
每天跟 AI 编程助手对话，产出了一堆高价值的东西：一次 Docker 排障的完整过程、一版架构设计的取舍理由、某个线上事故的复盘结论。但这些知识往往随着终端窗口一关就消失了。
想手动整理进团队的 Outline 知识库，又得复制粘贴，还会遇到一堆格式坑：Outline 自带的文档标题和正文首行的一级标题重复、Callout 提示框语法丢失、代码块语言标注错位、表格对不齐……整理一次心累一次，久而久之就没人整理了。
outline-skill 就是来解决这个问题的：它给 AI 智能体装上「原生读写 Outline」的能力，会话结束一句话就能自动沉淀成规范的 Runbook。
它能做什么
1. 标准 Agent Skill 规范，一键安装
遵循 agentskills.io 社区标准构建，一条命令全局安装，自动适配各类 AI 助手：
npx skills add huangy7/outline-skill -g
也可以只装给某个 Agent，比如 --agent claude-code 或 --agent gemini-cli。
2. Outline 专属排版护栏
- 自动消除标题冲突：不再出现 Outline 文档标题和正文首行一级标题打架；
- 原生支持 Callout 块：规范生成 Outline 专属的
:::info、:::tip、:::warning、:::danger语法容器； - 自动标注代码块语言、Markdown 表格标准对齐。
3. 双引擎架构：MCP + 零依赖 CLI 兜底
- 环境里配了 Outline MCP Server？直接调度
list_documents、create_document等原生 MCP 工具； - 没配 MCP 也不怕：内置基于 Node 18+ 原生 fetch 的独立命令行客户端（
scripts/outline-client.mjs），无依赖也能完成文档的增删改查全套操作。
4. 智能知识沉淀工作流
装好之后直接用自然语言指挥就行，比如：「把刚才的 Docker 排障过程整理成手册，保存到 Outline 运维知识库」。创建前它会自动比对已有文档，避免同名或冗余页面重复创建。
安装与配置
三种安装方式，按需选择：
- 通用一键安装（推荐）：
npx skills add huangy7/outline-skill -g - 交互式向导：
npx outline-skill setup，按提示填 Outline 实例地址（如https://app.getoutline.com或自建域名）和 API Token（在 Outline 的 Settings → Account → API Tokens 里创建），向导会自动校验连接； - 手动克隆：
git clone到~/.claude/skills/outline-wiki（Claude Code）或~/.gemini/config/skills/outline-wiki（Antigravity）等对应目录。
配置支持环境变量（OUTLINE_URL / OUTLINE_API_KEY）或 ~/.config/outline-skill/config.json 配置文件两种方式。
独立 CLI 也能直接在终端或 CI 脚本里用：
node scripts/outline-client.mjs auth:check
node scripts/outline-client.mjs documents:search --query "Docker"
开源信息
- 开源协议：MIT，完全免费、无商业闭源限制
- 仓库地址：github.com/huangy7/outline-skill
- 运行环境：Node.js 18+，跨平台（macOS / Linux / Windows）
适合谁用
- 日常用 Claude Code、Cursor、Antigravity 写代码，且团队用 Outline 做知识库的开发者；
- 想把排障 Runbook、架构决策、技术复盘自动归档，告别手动复制粘贴的团队。
评论区