TeamOS Wiki

主题

同事接入 Wiki 发布流程 ​

不需要懂 git，不需要懂 SSH。装好 Claude Code、装好 vault-publish skill 后，你只要在 Claude Code 里说一句话："发布 wiki"，它会全程当向导。

本文分两段：

  • §1 一次性准备：每台机器只做一次（10 分钟）
  • §2 日常使用：写完笔记后两条话搞定

1. 一次性准备（10 分钟） ​

1.1 你需要先装好的东西 ​

软件必装用途怎么装
Git✅版本控制https://git-scm.com/downloads
Claude Code✅AI 助手https://claude.com/product/claude-code
Obsidian推荐写 Markdown 笔记的最舒服工具https://obsidian.md/download
GitHub 账号✅团队 wiki 仓库托管在 GitHub 上https://github.com/signup

1.2 装 vault-publish skill ​

打开 Claude Code，告诉它：

帮我装 vault-publish skill，下载到 ~/.claude/skills/vault-publish/

或者手动从 Allen 那里拿到 vault-publish/SKILL.md，拷贝到：

  • Windows：C:\Users\<你的名字>\.claude\skills\vault-publish\SKILL.md
  • Mac/Linux：~/.claude/skills/vault-publish/SKILL.md

装完重开一次 Claude Code，让它能认到新 skill。

1.3 把你的 GitHub 用户名告诉 Allen ​

发给 Allen：

我的 GitHub 用户名是：<your-github-username>，请给我加 wiki-vault 的 collaborator 权限。

Allen 会在 https://github.com/daishiyu1991-hub/wiki-vault/settings/access 里把你加成 Write 权限。

你会收到一封 GitHub 邀请邮件，记得点接受。

1.4 配 SSH key + 拉仓库 ​

打开 Claude Code，告诉它：

帮我配 SSH key 并克隆 wiki-vault 到本地 <你想放的路径>，然后让 Obsidian 把这个目录当 vault 打开。

Claude 会自动按 vault-publish skill 里的 Step 3 走完整流程：

  1. 检查你机器上有没有现成的 SSH key
  2. 没有就帮你生成一个
  3. 把公钥复制到剪贴板
  4. 告诉你打开 https://github.com/settings/ssh/new 把它粘进去
  5. 验证 SSH 通到 GitHub
  6. git clone git@github.com:daishiyu1991-hub/wiki-vault.git

整个过程你只需要做一件事：把公钥粘到 GitHub 那个网页里。

看不懂 SSH 是什么没关系，详细解释在 vault-publish skill 的 Step 3 里，每个错误都有对应的解决方法。

2. 日常使用 ​

2.1 vault 目录结构 ​

clone 下来后你会看到：

wiki-vault/
├── canon/        # 已审核 / 公开发布的内容 ← 你写新内容放这里
│   ├── concepts/
│   ├── entities/
│   ├── system/
│   ├── syntheses/
│   ├── _assets/   # 图片/视频/PDF 等（自动走 Git LFS）
│   ├── index.md
│   └── log.md
├── drafts/       # ECS 上 hermes 写的草稿，等审批的（你一般不动）
├── personal/     # （可选）你的私人笔记，被 .gitignore 忽略，永不上传
├── .gitattributes
└── .gitignore

写新内容请放 canon/ 下对应分类目录。比如做了一份品类分析放 canon/品类/<品类名>.md。

如果是私人备忘、想法草稿不想给别人看，放 personal/，它在 .gitignore 里被忽略，永远不会被 push。

2.2 写完笔记后发布 ​

打开 Claude Code，说一句话即可：

发布 wiki

Claude 会自动按 vault-publish 跑完：

[1] 检查 vault 路径 ✓
[2] 检查 SSH 通 ✓
[3] git pull --rebase 拉同事最新 ✓
[4] git add canon/（personal/ 被 .gitignore 自动隔离）✓
[5] 询问你这次写的是什么 → 生成 commit message
[6] git push origin main ✓
[7] 报告：图片走 LFS 上传 X 个、文档 push 成功

push 完一两分钟内：

  • ECS 上的 Hermes 立刻能读到你新加的内容
  • https://wiki.86lux.net 静态站自动重建，团队任何人都能看

2.3 拉别人的更新 ​

每天开干前 / 准备发布前，让 Claude：

拉 wiki 最新

它会跑 git pull --rebase origin main。

3. 写 wiki 的几条规矩 ​

规矩原因
写新页前先看 canon/index.md 有没有相关页避免重复造页
文件名用中文 + 短横线分类，不要用空格 + 各种符号URL 友好、跨系统不出错
内链用 <span class="wikilink-dead" title="未找到: 页面名" style="color:#c33;border-bottom:1px dashed #c33">页面名</span>，不要写 https://wiki.86lux.net/...wikilinks 自动维护，搬目录不会断
图片放 canon/_assets/<主题名>/ 下自动走 Git LFS，仓库不膨胀
YAML frontmatter 写全：title / type / created / updated / tags给 Hermes Agents 当结构化元数据用
你修改别人的页，加一行 **[Allen 2026-04-17 修订]** 说明不抹历史，留痕迹
删页前先在群里 @ 一下避免删了别人正在用的引用

4. 常见问题 ​

Q：我能直接用 GitHub 网页改吗？ A：能，但建议改完之后本地 git pull 一下保持一致。

Q：我误把 personal/ 推上去了怎么办？ A：不会发生，personal/ 在 .gitignore 里被忽略。即使你手动 git add personal/ 也不会成功。如果是其他不该发的内容（比如误推到 canon/），找 Allen 用 git revert 撤回。

Q：我能不能不用 Obsidian，用 VSCode 写？ A：能。任何能写 markdown 的工具都行。Obsidian 的好处是 <span class="wikilink-dead" title="未找到: wikilinks" style="color:#c33;border-bottom:1px dashed #c33">wikilinks</span> 自动补全 + 支持双向链接图谱。

Q：图片粘进 Obsidian 自动保存到哪？ A：在 Obsidian 设置里把 "Files & Links → Default location for new attachments" 设成 canon/_assets/。详见 wiki图片视频管理规范。

Q：我没装 Claude Code，能用别的工具发布吗？ A：能。完全不用 Claude Code 也行，vault-publish skill 的内容本质是一份手动 git 操作清单，照着走就能完成。

5. 出错了怎么办 ​

报错大概率原因解决
Permission denied (publickey)SSH key 没配好让 Claude 重跑 vault-publish Step 3
Updates were rejected没先 pullgit pull --rebase origin main
wiki.86lux.net 没更新VitePress 重建失败找 Allen 看 ECS 日志
Multica 拒绝你的 draft内容质量没过看 Multica 给的反馈，改完重提

实在搞不定，截图 + 错误信息发群里 @Allen，比自己瞎试 30 分钟好。

关联 ​

TeamOS · docs as code · canon=权威知识，drafts=候选区

© 86lux.net