Evidoc — 面向 agentic repositories 的文檔漂移控制
- TypeScript
- Node.js
- MCP
- GitHub Actions
- CLI
- Local Web UI
- Documentation Drift
- Agent Workflows
一個公開、本地優先的開發者工具，用於檢查 README、docs、AGENTS.md、CLAUDE.md、examples、API notes 與源碼綁定文檔是否仍然描述當前真實 repo。它讓人工審查、CI 與 coding agents 在信任或修復過期上下文前，使用同一份 repo-local evidence。
一眼看懂
角色 獨立開發者 — 產品定位、CLI、MCP server、本地 Command Center、GitHub Action、Local Git Gate、release workflow
問題
Agentic repositories 很容易累積過期指令：README commands 與 package scripts 漂移，AGENTS.md 和 CLAUDE.md 保留舊路徑，examples 不再匹配 API，而 coding agents 可能在檢查源碼前先信任這些說法。Evidoc 把這個信任問題轉成一套本地 evidence workflow。
解法
我把信任檢查包成一套本地工作流，覆蓋 CLI、MCP server、本地 Web UI 與 GitHub Action。每個入口都先把文檔主張對照 repo 證據，再提出修復建議或阻斷 gate。
成果
公開 v0.3.2 · 已於 npm 以 @evidoc/evidoc 發布 · CLI、MCP server、Local Web UI、GitHub Action、Local Git Gate · CLI、core、dashboard、local app、MCP server、reports 與 review log package artifacts
我的工作
- CLI 工作流：檢查 drift、運行 doctor diagnostics、生成 repo-local reports，並在命令行執行 local gates
- 面向 coding agents 的 MCP server，把 drift status、scans、diagnosis、doc-fix suggestions 與明確 review logging 作為受控 tools 暴露
- 雙語 Evidoc Command Center / Local Web UI，用於 repository health、triage、repair prompts 與 local-gate visibility
- GitHub Action 支持 CI-side drift checks、PR feedback、changed-file focus，並能檢測舊 DriftGuard action references 的相容性
- v0.1.0 release 完成 DriftGuard -> Evidoc rename，覆蓋 CLI、npm packages、.evidoc state、MCP、GitHub Action、local app 與 docs
- v0.3.x 以 npm scoped package @evidoc/evidoc 發布，承接 Evidoc namespace 遷移、topological npm publication 與 0.3.2 發布加固
技術證據
- Repo-local evidence model：先對照 commands、paths、symbols、package scripts、frontmatter source bindings、API surfaces 與 changed files，再信任文檔 claims
- Agent-safe defaults：預設 read-only checks，review logs 與 repair proposals 有明確寫入邊界，且不依賴遠端項目知識
- Repair workflow 把 evidence、diagnosis 與 patch suggestions 分開，使 generated fixes 保持可審查，而不是靜默改寫 repo truth
- Release hardening 覆蓋 doctor readiness、scoped package artifacts、GitHub Action behavior，以及與當前 scoped npx 和 local GUI paths 對齊的 docs
為什麼文檔漂移重要
Coding agents 越來越常先讀 repository instructions，再讀 source files。如果這些 instructions 過期，agent 可能會很自信地執行已不存在的 commands、paths、policies 或 examples。
Evidoc 讓文檔信任變得明確：先掃描 repo、收集 evidence、標記 stale claims，再決定修文檔、阻斷 gate，或交給人工審查。
CLI、MCP、Command Center、CI
同一套 evidence workflow 覆蓋多個入口：CLI 做本地檢查，MCP server 服務 agent workflows，Local Web UI 用於 triage，GitHub Action 用於 pull-request feedback。
v0.1.0 release 把這些入口統一到 Evidoc 名稱下，同時保留對舊 DriftGuard action references 的相容性檢測。
當前分發經由 npm scoped package @evidoc/evidoc，版本為 v0.3.2，承接 namespace 遷移與 release hardening。
受控修復，而不是盲目自動化
這個工具圍繞可審查 evidence 設計，而不是靜默 rewrite。它可以生成 fixes 與 prompts，但 diagnosis、proposal 與 accepted repository change 的邊界保持可見。