Agent 原生团队工作台¶

核心判断¶

这个仓库不应该只是一个文档仓库，而应该成为团队的 Agent 原生工作台。

目标是：

团队成员 clone 仓库后，用 Codex 或 Claude Code 打开项目，就能按照统一规则参与讨论沉淀、知识库维护、文档发布和共识对齐。

第一阶段不急着做 Skills 和 MCP¶

Skills 和 MCP 都很有价值，但第一阶段不应该过早固化。

更稳的顺序是：

repo 规则
  -> workspace 结构
  -> Agent 工作流
  -> PR/CI 协作
  -> 高频动作脚本化
  -> 稳定后再抽象成 skills / MCP

原因：

现在团队流程还在形成，过早做 skill 容易写成僵硬说明。
MCP 适合连接外部系统，但需要明确权限、安全和数据边界。
根目录 AGENTS.md 和 CLAUDE.md 已经能让 Codex/Claude Code 进入同一套协作模式。

当前已具备的协作入口¶

AGENTS.md
  Codex 默认操作指南

CLAUDE.md
  Claude Code 操作指南

workspaces/variai/knowledge/system/AGENTS.md
  Knowledge 维护规则

.github/pull_request_template.md
  PR 检查清单

.github/ISSUE_TEMPLATE/knowledge-task.md
  知识任务模板

scripts/vault_lint.py
  Evidence / Knowledge 结构健康检查

团队成员如何开始¶

clone 仓库：

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

用 Obsidian 打开：

harness/workspaces/variai/knowledge/

用 Codex 或 Claude Code 打开仓库根目录：

harness/

让 Agent 先读：

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

开始任务：

把这段群聊讨论整理进 workspaces/variai/evidence/inbox，并提炼为 wiki 页面。

或：

把 Knowledge 中成熟的团队协作模式整理成 Site 页面，并更新 mkdocs 导航。

Skills 的后续方向¶

当流程稳定后，可以把高频任务做成 Codex/Claude Code skills：

harness-ingest：整理 inbox/raw。
harness-publish：从 Knowledge 发布到 Site。
harness-lint：检查知识库健康度。
harness-adr：生成和维护 ADR。
harness-scenario：把业务场景整理成方案包。

这些 skills 应该引用仓库内模板和脚本，而不是只写提示词。

MCP 的后续方向¶

MCP 适合在需要连接真实系统时引入。

候选 MCP：

GitHub MCP：issue、PR、review、项目管理。
Obsidian/Knowledge MCP：搜索、读取、写入 Knowledge 页面。
飞书/企业微信 MCP：捕获群聊讨论、发送摘要、创建待办。
Browser/Search MCP：调研外部资料。
Cloudflare MCP：部署和状态检查。

第一阶段可以先不用 MCP，避免把简单文件协作复杂化。

最小可行协作闭环¶

群聊讨论
  -> Agent bot 或成员写入 workspaces/variai/evidence/inbox
  -> Agent 编译到 workspaces/variai/knowledge/wiki 或 workspaces/variai/knowledge/decisions
  -> PR review
  -> 成熟内容发布到 Site
  -> Cloudflare 自动部署
  -> 群里分享链接

这个闭环跑顺后，再逐步把工具和流程产品化。

Agent 原生团队工作台¶

核心判断¶

第一阶段不急着做 Skills 和 MCP¶

当前已具备的协作入口¶

团队成员如何开始¶

推荐 Agent 任务¶

Capture¶

Ingest¶

Publish¶

Lint¶

Review¶

Skills 的后续方向¶

MCP 的后续方向¶

最小可行协作闭环¶