tiangong-wiki-skill

Wiki Skill

将本地 wiki 作为持久知识层使用——不仅服务于当前对话，也服务于未来所有工作。先查询，再读取或编辑作为事实来源的 Markdown 文件。

在 macOS、Linux、WSL 和 Git Bash 上使用 tiangong-wiki <command>。

在 Windows 原生 shell（如 PowerShell、命令提示符）、后台守护任务或 Codex 工作自动化中，须显式使用 npm 命令 shim：

tiangong-wiki.cmd doctor
tiangong-wiki.cmd sync
tiangong-wiki.cmd lint --format json

不要在 Windows 原生 shell 中调用不带后缀的 tiangong-wiki 可执行文件。npm 也会为类 POSIX 环境安装该 shebang 脚本，但 Windows 可能将其视为未知文件，打开“选择应用”对话框而不执行 CLI。

在以下三种场景中激活本技能：

在回答或行动前，需要历史知识、方法、行为模式或既往决策。

触发条件： 当前任务可能受益于此前记录的洞见，或用户询问的内容可能已存在于 wiki 中。

最小步骤：

根据已知信息选择检索策略：
- 知道类型、标签或元数据 → tiangong-wiki find
- 有关键词或短语 → tiangong-wiki fts
- 意图模糊且已配置嵌入 → tiangong-wiki search
- 需要图谱上下文或相关页面 → tiangong-wiki graph
用 tiangong-wiki page-info <id> 检查最佳候选页面。
如需完整内容，读取 Markdown 文件。

停止条件： 已有足够上下文继续，或不存在相关页面。

对话、任务或其他技能产生了高价值洞见、方法、修正或值得保存的信息。

触发条件： 你识别出持久知识——在将来上下文中检索会有用的内容。

两条路径：

直接创建页面 —— 当你能清晰识别页面类型并自行组织内容时：
1. 搜索现有页面以避免重复（find、fts 或 search）。
2. 发现本体：tiangong-wiki type recommend --text "<summary>" --keywords "a,b,c" --format json。
3. 若已有页面覆盖同一知识对象则更新它；仅当对象不同时才创建新页面。
4. 写入后：tiangong-wiki sync --path <page-id>，然后 tiangong-wiki lint --path <page-id> --format json。
保存到 vault —— 当材料原始、复杂或需要进一步处理时：
1. 将文件保存到 vault/。
2. vault 到 wiki 的工作流将负责分诊和页面创建。
3. 完整决策模型见 references/vault-to-wiki-instruction.md。

关键规则：

在检索或对话过程中发现既有 wiki 内容过时、错误或不完整。

触发条件： 检索到的页面包含陈旧信息，或新证据与既有内容矛盾。

最小步骤：

定位页面：tiangong-wiki find 或 tiangong-wiki page-info <id>。
编辑 Markdown 文件——保持编辑最小化并保留出处。
编辑后：tiangong-wiki sync --path <page-id>，然后 tiangong-wiki lint --path <page-id> --format json。

系统化维护（健康检查、孤儿清理、陈旧内容审查）参见 references/wiki-maintenance-instruction.md。

文档	阅读时机
`references/cli-interface.md`	需要完整命令选项、标志或输出格式细节时
`references/vault-to-wiki-instruction.md`	处理 vault 文件并转换为 wiki 页面时
`references/wiki-maintenance-instruction.md`	运行系统化维护或健康检查时
`references/template-design-guide.md`	设计新页面类型或演进现有模板时
`references/troubleshooting.md`	环境设置、配置问题或错误诊断时