SuperAPI AI 工具集

wiki-term-research

写作与研究

查看项目

更新于 10-15 09:48

技能介绍

用途

Wiki Term Research 用于创建生产级、经过深度研究的 wiki 术语条目。每个条目既可作为快速参考,也可作为完整的学习资源。所有术语都必须经过强制的网络研究、交叉引用验证和质量检查。

主要能力

  • 对指定术语进行网络研究,查找权威定义、行业标准和实践指导。
  • 按照模板撰写结构化条目,包含 TLDR、定义、工作原理、实践示例和外部参考等部分。
  • 校验交叉引用,确保相关术语 slug 存在,并避免别名导致错误的自动链接。
  • 更新相关术语,将新术语加入紧密相关条目的关联列表。
  • 执行质量验证,检查 frontmatter 和内容清单。
  • 识别并输出建议的未来术语列表。

使用方式

输入

  • 术语名称:需要研究和记录的概念。
  • 领域上下文(可选):wiki 所属的行业或主题领域,例如“construction finance”“healthcare compliance”“SaaS metrics”。
  • 深度覆盖(可选):用户可要求“quick”(简略)或“comprehensive”(最大深度)。默认:comprehensive。

开始之前

  1. 找到 wiki 内容目录。查找 WRITING_GUIDE.md、AGENTS.md 或 src/content/ 目录结构。
  2. 如果存在写作指南,请阅读它。它是格式规则的权威来源。如果本技能中的任何内容与项目特定的写作指南冲突,以写作指南为准。
  3. 扫描现有术语以校准深度、语气和惯例:列出术语目录以查看现有文件名和分类;阅读 2-3 个相关术语以了解预期质量水平。

工作流程

阶段 1:定位与现有内容审计

  • 搜索该主题的现有条目,检查术语是否已存在(更新还是创建)。
  • 通过阅读相关术语,扫描现有分类和标签以了解惯例。
  • 确定 slug——使用 kebab-case,具有描述性,仅在含义有实质差异时添加地区后缀。
  • 阅读 3-5 个紧密相关的条目,了解差距和交叉引用机会。

阶段 2:网络研究(强制)

此阶段不是可选的。每个术语条目都必须有网络研究支持。

  • 阅读 references/research-guide.md 了解搜索查询模式和来源质量层级。
  • 至少:运行 3 次以上 WebSearch 查询,查找权威定义、行业标准和实践指导;通过 WebFetch 抓取 1-3 个权威页面,提取准确定义、要求和示例。

阶段 3:撰写条目

  • 阅读 references/article-template.md 了解完整模板和使用说明。
  • 必填部分:TLDR(2-4 句话,是什么?为什么重要?);What it is(清晰定义,扩展摘要);How it works(机制、流程或应用);Practical example(使用真实数据的具体示例);External references(至少 3 个指向可靠来源的链接)。
  • 可选部分(相关时包含):地区/司法管辖区细节;标准条款或规范;常见陷阱;行业角色/为什么对产品重要。

阶段 4:交叉引用验证

  • 验证所有相关 slug 存在。如果相关 slug 不存在,包含它但标记为缺失术语。
  • 检查别名不会导致错误的自动链接。避免单个常见词。多词短语和特定缩写是安全的。
  • 更新相关术语——检查 2-3 个紧密相关的现有术语是否应将此新术语加入其关联列表。

阶段 5:质量验证

Frontmatter 清单:标题具体且与 slug 匹配;摘要恰好一句话,语言平实;标签具体且可搜索(5-8 个标签);分类使用 wiki 中已有的分类;别名精确,无通用词;Related 有 3-6 个条目,使用 slug 格式。

内容清单:TLDR 存在且能在 15 秒内提供有用信息;至少一个使用真实数据的实践示例;至少 3 个带 URL 的外部参考;条目使用 ##/### 层级清晰易读;读者能在 60 秒内了解要点。

研究清单:至少执行了 3 次 WebSearch 查询;至少抓取并阅读了 1 个权威来源;没有关于要求或标准的无来源声明。

阶段 6:缺失术语识别

撰写条目后,审查正文中提到但不在 wiki 中的概念。输出“Suggested future terms”列表,包含术语名称和一句话理由。

参考文件

  • references/article-template.md——完整文章模板,包含所有部分和使用说明。
  • references/research-guide.md——搜索查询模式、来源质量层级和研究方法。

适用场景

  • 用户要求“创建 wiki 术语”“撰写术语条目”或类似请求时。
  • 需要为特定领域(如建筑金融、医疗合规、SaaS 指标)构建结构化知识库时。
  • 需要确保术语条目经过网络研究、交叉引用验证和质量检查时。

限制

  • 网络研究是强制性的,无法跳过。
  • 如果项目存在写作指南,以写作指南为准,本技能中冲突的内容不适用。
  • 相关 slug 不存在时只能标记为缺失术语,不能自动创建。
  • 别名需避免通用词,否则可能导致错误的自动链接。