SuperAPI AI 工具集

dsh-doc

写作与研究

查看项目

更新于 10-15 20:35

技能介绍

用途:为 DeepSeek Harness 仓库编写、重构、审阅、审计或迁移 Markdown 文档,包括包 README 与文档网站。目标是让每个页面可搜索、新手可读,并对智能体和维护者足够精确,同时把文档网站保持为仓库 Markdown 的受测投影。

主要能力:按页面主用途和读者分类(产品快速开始、用户任务指南、贡献者教程、架构概览、包/子系统参考、生成参考、智能体指令、决策记录、草稿);用 kind 元数据映射模板(package-group、package-reference、package-library、package-bundle、persistence-change、persistence-release、persistence-format、upgrade-guide 等),按 Summary、目录、用户内容、开发者内容、Further Exploration、Dev Note 的顺序编写;维护行对齐的中英双语配对;对语料做审计、字数预算检查和网站发布。

使用方式:先读各级 AGENTS.md 与文档标准,再对目标页做事实核对——实际运行文档中声称的命令、配置片段与示例,只记录观察到的行为;无法复现的声明要删除。每处配对编辑后运行 pnpm run verify-translation-pairing --write <pair> 重新记录。合并前运行 pnpm run test:docs、pnpm run doc-sync、pnpm run lint 与 git diff --check。网站内容只编辑 docs/ 下的规范源,website/docs.ts 是公开允许清单,禁止编辑 website/.generated/、website/.cache/、website/.dist/。

适用场景:文档新写与整改、包 README 评审、双语页面校验、语料审计与字数超限、文档网站发布。

限制:资料未给出具体版本、价格或平台支持信息;命令、默认值与行为必须以当前代码和测试为准,不得凭记忆或类比写入。