Agent 原生团队工作台¶
核心判断¶
这个仓库不应该只是一个文档仓库，而应该成为团队的 Agent 原生工作台。
目标是：
团队成员 clone 仓库后，用 Codex 或 Claude Code 打开项目，就能按照统一规则参与讨论沉淀、知识库维护、文档发布和共识对齐。
第一阶段不急着做 Skills 和 MCP¶
Skills 和 MCP 都很有价值，但第一阶段不应该过早固化。
更稳的顺序是：
text
repo 规则
-> vault 结构
-> Agent 工作流
-> PR/CI 协作
-> 高频动作脚本化
-> 稳定后再抽象成 skills / MCP
原因：
- 现在团队流程还在形成，过早做 skill 容易写成僵硬说明。
- MCP 适合连接外部系统，但需要明确权限、安全和数据边界。
- 根目录
AGENTS.md和CLAUDE.md已经能让 Codex/Claude Code 进入同一套协作模式。
当前已具备的协作入口¶
```text AGENTS.md Codex 默认操作指南
CLAUDE.md Claude Code 操作指南
vault/90-system/AGENTS.md Obsidian vault 维护规则
.github/pull_request_template.md PR 检查清单
.github/ISSUE_TEMPLATE/knowledge-task.md 知识任务模板
scripts/check.ps1 本地构建和 vault lint 检查
scripts/vault_lint.py Karpathy LLM Wiki 结构健康检查 ```
团队成员如何开始¶
- clone 仓库：
bash
git clone https://github.com/alpc91/harness.git
- 用 Obsidian 打开：
text
harness/vault/
- 用 Codex 或 Claude Code 打开仓库根目录：
text
harness/
- 让 Agent 先读：
text
AGENTS.md
vault/90-system/AGENTS.md
- 开始任务：
text
把这段群聊讨论整理进 vault/00-inbox，并提炼为 wiki 页面。
或：
text
把 vault 中成熟的团队协作模式整理成 docs 页面，并更新 mkdocs 导航。
推荐 Agent 任务¶
Capture¶
把群聊、会议、网页、截图说明放入 vault/00-inbox/。
长期应通过飞书群/企业微信群 Agent bot 自动完成，而不是人工截图。
Ingest¶
把 inbox/raw 编译成 wiki、project 或 decision 页面。
Publish¶
把成熟 vault 内容发布到 docs/，更新 MkDocs 网站。
Lint¶
检查知识库健康度：
- 重复页面。
- 缺少来源。
- 过期判断。
- 没有索引的页面。
- 可以发布但尚未发布的内容。
- 潜在敏感信息。
Review¶
对 PR 做审查：
- 是否泄露敏感信息。
- 是否有构建验证。
- 是否符合目录分工。
- 是否需要补 ADR。
Skills 的后续方向¶
当流程稳定后，可以把高频任务做成 Codex/Claude Code skills：
harness-ingest：整理 inbox/raw。harness-publish：从 vault 发布到 docs。harness-lint：检查知识库健康度。harness-adr：生成和维护 ADR。harness-scenario：把业务场景整理成方案包。
这些 skills 应该引用仓库内模板和脚本，而不是只写提示词。
MCP 的后续方向¶
MCP 适合在需要连接真实系统时引入。
候选 MCP：
- GitHub MCP：issue、PR、review、项目管理。
- Obsidian/Vault MCP：搜索、读取、写入 vault 页面。
- 飞书/企业微信 MCP：捕获群聊讨论、发送摘要、创建待办。
- Browser/Search MCP：调研外部资料。
- Cloudflare MCP：部署和状态检查。
第一阶段可以先不用 MCP，避免把简单文件协作复杂化。
最小可行协作闭环¶
text
群聊讨论
-> Agent bot 或成员写入 vault/00-inbox
-> Agent 编译到 vault/20-wiki 或 vault/40-decisions
-> PR review
-> 成熟内容发布到 docs
-> Cloudflare 自动部署
-> 群里分享链接
这个闭环跑顺后，再逐步把工具和流程产品化。