SuperAPI AI 工具集

content-editing

数据与分析

查看项目

更新于 10-15 22:37

技能介绍

用途:面向 InfluxData 文档仓库的内容编辑工作流,覆盖新建、编辑、共享内容管理与校验。

主要能力:使用 docs create 从草稿创建文档,docs edit 按 URL 或路径编辑,docs edit --list 仅列出文件,docs placeholders 为代码块添加占位符;管理 Hugo 共享内容(shared 目录加 source 前置元数据),编辑共享文件后需 touch 引用它的前置元数据文件以触发重建,docs edit 会自动处理;运行 Hugo 构建、Vale 风格检查、代码块语法与执行测试、链接校验和 Cypress E2E 测试;通过文档 MCP 服务器做事实核查。

使用方式:常用命令包括 yarn hugo --quiet 构建、.ci/vale/vale.sh --config=.vale.ini content/path/ 做风格检查、yarn lint-codeblocks content/path/*.md 检查代码块语法、yarn test:codeblocks:all 测试代码块、link-checker map ... | xargs link-checker check 校验链接(需先构建)、yarn hugo server 本地预览。MCP 服务器托管于 https://influxdb-docs.mcp.kapa.ai,无需本地安装,提供 search_influxdb_knowledge_sources 语义搜索工具,含 API key 与 OAuth 两种接入方式。

适用场景:多产品共享文档的编辑与同步、提交前测试与风格校验、技术准确性核查、内容缺口分析。

限制:MCP 仅检索文档而非实时系统,不能替代测试;风格与语法检查应使用 Vale,链接校验用 link-checker,代码示例测试用 yarn test:codeblocks。具体安装与配置细节资料未完整提供。