SuperAPI AI 工具集

wiki-writing

写作与研究

查看项目

更新于 10-16 06:42

技能介绍

用途:这是 Hermes LLM Wiki 的默认写作技能,指导作者和策展人编写与维护符合 Wiki Schema 的页面;wiki 可通过 hermes wiki skills set writing <skill-name> 覆盖此默认技能。

页面类型(取最窄且合适的一种,定义于各 wiki 的 SCHEMA.md):source(单个不可变来源快照的策展摘要,由摄取生成,很少手写)、entity(人物、组织、产品、项目等具体名词)、concept(想法、方法、模式、主张、机制)、comparison(实体或概念间的结构化权衡)、query(保存的研究问题及回答轨迹)、summary(跨多页的综合概述)。

创建页面:hermes wiki create-page "Page Title" --body "Markdown body…" --type concept --tag <taxonomy-tag> --source sources/<source-page-id> [--wiki <slug>] [--author <name>] [--author-kind agent|profile|human|cron]。需要写入授权;同标题重跑会更新(内容合并、刷新 updated)而非重复创建。

Frontmatter 契约:每页携带 YAML frontmatter,必需键来自 SCHEMA.md 的 required_frontmatter,默认含 id(<type-dir>/<slug>,创建后永不变)、title、type、created、updated、author、author_kind(agent|profile|human|cron)、sources、tags。sources 必须指向真实来源页;tags 必须取自 SCHEMA.md 的 Taxonomy,若要新增应提议修改分类法而非自造标签。

正文约定:使用标准相对 Markdown 链接(如 Agent Memory),不用 wiki-link 语法、绝对路径或裸 URL 引用内部页面;慷慨交叉链接;遵守 Schema 的 page_line_limit(默认 200 行),超限则拆分或建 summary 页;页面历史不入正文,由 log.md、git 和投影渲染。

综合协议:页面创建阈值(去重)——当实体或概念出现在 2 个以上来源,或对某一来源为核心时创建页面;创建前先搜索(hermes wiki search "<title>"),若已有相近页面则扩展而非重复。矛盾协议——新信息与现有页面冲突时:检查日期,较新来源通常取代较旧来源,更新断言并引用两来源页及日期,保留旧断言仍成立的部分;若真正矛盾且无明确新旧胜出者,在正文记录两种立场及日期与来源,设置 contested: true 并在 contradictions: 记录冲突页面 id,lint 会以 unresolved_contested 提示待审,直至人工或代理解决;绝不可静默合并冲突断言或在无依据下选胜出方。归属——综合 3 个以上来源的页面,每段若断言来自某一具体来源,段末以相对链接标注(如 (source));单来源页面依赖 frontmatter 的 sources: 字段;对支撑弱的断言在正文中措辞谨慎(如“field reports suggest…”)并据实设置 confidence(单一轶事来源为低而非高)。

传播(写入后):按 Propagation Rules,持久写入还会更新对应 index.md 分节目录、在 log.md 追加带归属行、刷新 SQLite 投影(wiki.db)、以执行作者身份提交到 wiki 本地 git 仓库;CLI/工具会自动完成,切勿直接编辑投影状态跳过;手动批量编辑后运行 hermes wiki lint 校验与修复。

看板关联:页面驱动或跟踪工作时可 hermes wiki link <page-id> <task-id>,用 hermes wiki refs <page-id> 查看引用。

策展规则:更新优先于重复(先 hermes wiki search 再扩展);断言可归属(引用来源页、confidence 诚实);comparison 至少需两个真实主题页并链接两者;被取代内容归档到 _archive/ 而非删除。

提交前自检:每次持久写入前确认——每条断言可追溯到 sources: 所列页面,无来源不支持内容或抬高确定性;满足页面创建阈值且搜索确认无现有页面已覆盖;与现有页面的冲突按矛盾协议处理,无静默合并;confidence 诚实反映来源强度;标签来自 Schema 分类法、链接可解析、正文在 page_line_limit 内。任一项不通过则修正页面并复查后再写入。