SuperAPI AI 工具集

write-a-wiki-page

写作与研究

查看项目

更新于 10-15 23:33

技能介绍

用途:从已核实的来源撰写一篇有用的 wiki 页面,保留主张标题与引用语气,不得为凑页面编造事实。

主要能力:支持多种页面类型。Lore 使用 .brain/resources/lore/<slug>.svx,需主张标题与 idea、concept、source 或 person 分组;System 使用 .brain/areas/<slug>.svx,分组为 system,包含 What it does、The standard、How to check;Skill 使用 skills/<name>/SKILL.md,目录与 frontmatter 名称一致;Resource 放在 .brain/resources/,使用 /resources/<slug> 链接;Glossary 在 apps/site/scripts/content-lib.ts 中声明术语、定义与教学页。

写作要求:遵循 AGENTS.md 的 Wiki 写作规范,接近简化技术英语,句子约 20 词、描述句不超过 25 词,一句一个观点,用主动语态和现在时,同一事物用同一术语,优先列表,每步一条指令,去除习语与填充词。生成器会对超长句和超四句段落给出 file:line 警告,警告不导致构建失败。

配图与代码:流程图用围栏框线图,权衡用表格,逻辑用伪代码,文件位置用浅树,图宽不超过 80 列。代码片段须引用固定来源,使用 Markdown 围栏而非 <Code> 元素,元数据仅支持 repo、path、at、lines、title,at 为完整 40 位小写提交 SHA,最多一个高亮集,配置围栏最多显示 25 行源行。

引用与检查:frontmatter terms 只加页面支持的搜索词;用 <Ref page="/lore/source-page" id="claim"/> 引用已核实块;为事实来源添加 bibliography 条目。完成后运行 pnpm install --frozen-lockfile、pnpm --filter @rat-stack/site generate、pnpm turbo run check test build,并阅读生成的 HTML 与 Markdown 视图,核对 H1、固定摘录、术语链接与引用。

限制:不得编造事实、收费、平台或效果;缺失证据应标注而非补写;公开页面不得出现私有路径、主机名、凭据与客户数据。