mooqii/OpenPanels / agent-resources/preset-skills/zh-CN/wiki-default
wiki-default
Verified使用默认 Wiki 方法,根据经过整理的文档创建、扩充、编辑或维护持久的结构化 Wiki。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
| references/ingest-markdown-into-wiki.md | markdown | 3.3 KB |
| references/maintain-wiki.md | markdown | 2.2 KB |
| references/wiki-conventions.md | markdown | 8.0 KB |
references/wiki-conventions.md
View on GitHub# Wiki 生成规范
创建或修改生成的 Wiki 页面时,始终遵循本规范。
## 存储边界
生成的 Wiki 必须保持为可移植的干净 Markdown 文件树。不要要求使用数据库、向量库、图数据库、旁路清单、生成的 JSON 或其他持久索引才能理解或检索 Wiki。Markdown 的文件名、标题、别名、摘要、标签和链接就是检索结构。
提供的文档集合是来源层。不要在生成 Wiki 中创建 `raw/`、`sources/` 或逐文档镜像页面。
## 结构
新 Wiki 使用以下最小结构:
```text
SCHEMA.md
index.md
entities/<slug>.md
topics/<slug>.md
views/<slug>.md
```
某类页面第一次出现时再创建对应目录,不要强制创建空目录,也不要为每次顺带提及都创建页面。第一份来源只建立初始知识,不构成永久的领域边界;后续来源可以引入彼此无关的主题。
- `entities/`:人物、组织、产品、项目、地点、模型或其他具有持续价值的具名对象。实体页是该对象稳定身份的规范归属页,不是所有已观察状态的快照。
- `topics/`:概念、领域、方法、机制、定义、反复出现的观念和主题枢纽。主题枢纽可以概括并链接一个较大的领域。
- `views/`:可选的跨主题检索视图,例如对比、时间线、承诺、待确认问题或当前状态摘要。视图是派生的阅读路径,应链接规范的主题页和实体页,不要成为第二份事实来源。
不要创建按主题逐层嵌套的目录树。使用标签和 Markdown 链接表达多重归属,使同一页面可以属于多个主题。对比和总结通常应位于主题页或可选视图中,而不是单独的顶层目录。
已有 Wiki 应保留仍有价值的旧目录和页面。不要仅为了统一结构,就把旧的 `concepts/`、`comparisons/` 或 `summaries/` 页面复制到新结构。只有在明确执行重组且收益大于链接变更成本时,才迁移或重命名已有页面。
## 语义模型
- 对证据所描述的现实对象或概念建模,而不是复刻来源文档的提纲、章节名或存储结构。一份来源可以更新多个规范页面,多份来源也可以共同更新一个页面。
- 将稳定身份或定义与观察分开。日期、发布、测量、变化状态、预测和特定来源的论断应在正文中保留时间限定,不要把它们写成永久的身份字段。
- 有证据支持时,使用“属于”“由……开发”“依赖”“取代”“适用于”或“与……比较”等便于理解的关系名称。只有在无法确定更精确的关系时,才使用笼统的相关页面列表。
- 优先通过链接、别名和标签进行组合,不要建立深层分类树或重复页面。一个对象可以参与多个主题,同时只保留一个规范页面。
- 让语义模型逐步演进。某个关系名称、标签或页面约定在反复出现的场景中证明有用后,再加入 `SCHEMA.md`;不要根据第一份来源预先设计完整本体。
## 基础页面
第一次整合来源时,先创建 `SCHEMA.md` 和 `index.md`,再添加知识页面。已有 Wiki 应保留有价值的结构并更新这些页面,不要整体替换。
- `SCHEMA.md`:明确 Wiki 可以覆盖多个彼此无关的主题;记录目录分类、文件名和链接规范、持续演进的受控标签与别名词表、建页门槛以及特定主题的规则。保持简短。
- `index.md`:简洁的内容路由页。用单行摘要链接主要主题枢纽、重要实体和有用视图。不要把它变成穷举所有页面的扁平清单,也不要维护页面数量。每个有效页面都应能从索引沿简短且有意义的链接路径抵达,通常不超过一到两跳。
默认不创建 `log.md`。页面的 `updated` 字段和外围的版本系统负责常规变更历史。已有的 `log.md` 应予以保留,但只有当用户选择维护人类可读的审计日志时才继续更新。
## 页面语言
- 判断来源的主要自然语言时,忽略代码块、引用、参考文献和嵌入式标识符,依据正文判断。
- 新页面使用主要支持证据的主要语言。
- 更新已有页面时,保留它已经确立的语言,并用该语言连贯地整合新证据,不要逐段交替使用不同语言。
- 多份证据使用不同语言且没有明显主导语言时,已有页面沿用其现有语言;新页面使用主要来源或最早的权威来源所使用的语言。
- 专有名称和重要技术术语保留其通行写法,并把有用的译名、缩写、旧称和其他拼写加入 `aliases`。
- 除非用户明确要求多语言版本,否则不要按语言创建重复页面。
- `SCHEMA.md`、`index.md` 和已有视图沿用已经确立的语言。第一次整合时使用第一份来源的主要语言。
## 页面规范
- 使用稳定的小写连字符文件名和路径,例如 `topics/attention-mechanism.md`。页面语言日后发生变化时,不必因此翻译文件名。
- 每个生成的知识页面都以前言开头:
```yaml
---
title: 便于阅读的标题
aliases: [缩写, 其他拼写, 译名]
updated: YYYY-MM-DD
tags: [controlled, tags]
sourceIds: [stable-source-id]
---
```
- 保持前言精简。页面所在目录已经表达了大类角色。当页面内不同论断的证据质量不同时,不要添加页面级的置信度或争议字段。
- `aliases` 是检索结构的一部分。加入有用的缩写、其他拼写、旧称和常见译名,但不要为了增加命中率而堆砌推测性或无关关键词。
- `sourceIds` 只记录页面级出处。不要把完整来源复制进生成 Wiki;当具体论断的来源、日期、置信度或冲突情况很重要时,在该论断附近引用对应来源标识。
- 从 `SCHEMA.md` 使用少量受控主题标签。后续来源引入真正的新主题时,向词表添加具有持续价值的新标签或别名,不要强行套用第一份来源的分类。
- 在一级标题之后立即写一个简洁且可独立理解的摘要段落,用一到三句话说明主题是什么以及为何重要。摘要中应使用规范名称和重要术语,方便词法检索命中。
- 摘要后使用与页面语言一致、含义明确的标题。需要时优先设置关键知识、关系、证据或冲突等聚焦章节。
- 实体页应在靠前位置说明稳定身份或定义。易变化的事实应根据页面语言和主题放在带日期的状态、历史、观察或证据章节中。
- 关系章节应使用简短的带标签链接或句子说明对象之间如何关联。不要把关系编码为不透明标识,也不要要求额外的图数据结构。
- 使用标准相对 Markdown 链接连接相关页面,例如 `[注意力](../topics/attention.md)`。索引中的链接相对于根目录,例如 `[注意力](topics/attention.md)`。
- 新建或实质更新的页面应在确有相关页面时建立链接,不要为了满足数量而虚构关联。
- 保持页面聚焦且便于扫读。页面超过约 200 行时,将其拆成聚焦页面并更新链接和索引。
## 编辑原则
- 某主题是一份来源的核心,或在多个来源中反复出现时,可以独立成页;否则把有价值的细节并入已有页面。
- 创建页面前,搜索已有标题、路径、别名、标签和相关页面,寻找能够承接内容的规范页面。优先更新已有页面,不要为同义词或译名创建重复页面。
- 后续来源可以引入完全无关的主题。只要具有持续价值,就创建新的主题枢纽或索引分区,不要虚构它与已有主题的关系。
- 跨越多个主题的对象只保留一个规范页面,通过标签和链接表达所有有意义的归属。
- 新证据确认、细化、反驳或取代旧论断时,更新已有页面的 `updated` 日期和出处。
- 不要悄悄抹除重要冲突。在页面正文中同时说明相互冲突的论断、日期和来源文档标识,并让置信度和冲突说明靠近它所限定的论断。
- 保留有价值的用户页面和结构。不要因为所选 Skill 变化而重新生成、重命名或翻译无关页面。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |