用途
Wiki Term Research 用于创建生产级、经过深度研究的 wiki 术语条目。每个条目既可作为快速参考,也可作为完整的学习资源。所有术语都必须经过强制的网络研究、交叉引用验证和质量检查。
主要能力
- 对指定术语进行网络研究,查找权威定义、行业标准和实践指导。
- 按照模板撰写结构化条目,包含 TLDR、定义、工作原理、实践示例和外部参考等部分。
- 校验交叉引用,确保相关术语 slug 存在,并避免别名导致错误的自动链接。
- 更新相关术语,将新术语加入紧密相关条目的关联列表。
- 执行质量验证,检查 frontmatter 和内容清单。
- 识别并输出建议的未来术语列表。
使用方式
输入
- 术语名称:需要研究和记录的概念。
- 领域上下文(可选):wiki 所属的行业或主题领域,例如“construction finance”“healthcare compliance”“SaaS metrics”。
- 深度覆盖(可选):用户可要求“quick”(简略)或“comprehensive”(最大深度)。默认:comprehensive。
开始之前
- 找到 wiki 内容目录。查找 WRITING_GUIDE.md、AGENTS.md 或 src/content/ 目录结构。
- 如果存在写作指南,请阅读它。它是格式规则的权威来源。如果本技能中的任何内容与项目特定的写作指南冲突,以写作指南为准。
- 扫描现有术语以校准深度、语气和惯例:列出术语目录以查看现有文件名和分类;阅读 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 不存在时只能标记为缺失术语,不能自动创建。
- 别名需避免通用词,否则可能导致错误的自动链接。