跳转至

快速上手

你需要做什么

如果你是团队成员，按下面步骤加入协作。

1. Clone 仓库

git clone https://github.com/alpc91/harness.git
cd harness

2. 用 Obsidian 打开 Knowledge 工作区

打开 Obsidian，选择：

Open folder as vault

然后选择：

harness/workspaces/variai/knowledge/

这个文件夹就是当前 demo 的团队知识生产工作台。原始证据放在 workspaces/variai/evidence/，不要把未处理原文直接混进 Knowledge。

3. 用 Codex 或 Claude Code 打开仓库

打开仓库根目录：

harness/

让 Agent 先读：

AGENTS.md
CLAUDE.md
workspaces/variai/knowledge/system/AGENTS.md

4. 常用任务

把讨论放进 inbox：

把这段群聊讨论整理进 workspaces/variai/evidence/inbox，并保留日期、来源和待处理事项。

把 inbox 编译成知识页：

把 workspaces/variai/evidence/inbox 里的新材料 ingest 成 workspaces/variai/knowledge/wiki 和 workspaces/variai/knowledge/decisions 页面，并更新 index/log。

把成熟内容发布到网站：

把这个 wiki 页面整理成 Site 页面，写入 workspaces/variai/site/，更新 mkdocs.yml 导航，并运行构建验证。

5. 提交前检查

提交 PR 前跑 bash scripts/ci_check.sh（与 CI 同一套门禁），全绿即就绪；uv run mkdocs build --strict 只是站点局部快查，不能替代完整门禁。

站点局部快查：

uv run mkdocs build --strict

6. 提交 PR

提交内容前确认：

  • 没有 API key、token、密码。
  • Evidence/raw 资料没有被随意改写。
  • wiki 页面有“本页回答的问题”和“核心结论”。
  • ADR 有背景、决策、理由、影响。
  • 成熟内容才发布到 workspaces/variai/site/。

你不需要一开始做什么

第一阶段不强制：

  • 购买 Obsidian Sync。
  • 搭 MCP。
  • 写自定义 skill。
  • 所有人都装 Obsidian。
  • 完全自动化群聊抓取。

先把最小闭环跑顺。