Backstage: 反漂移项目治理协议
核心定位
Backstage 是一个元工作流技能,旨在解决 AI 辅助开发中最隐蔽的成本黑洞——上下文漂移。当工作脱离结构化边界时,人类需要付出三倍代谢成本(执行本身、解释方法论、定义知识存储位置)。本技能通过强制性的"进场/离场"仪式,将 3x 工作量压缩为 1x。
核心用法
触发模式(自然语言):
"bom dia PROJECT"/"good morning PROJECT"—— 启动模式:加载项目上下文,执行健康检查,阻止问题代码提交"boa noite"/"backstage end"—— 离场模式: victory lap、身体状态检查、自动关闭 VS Code"update backstage"—— 同步上游检查规则
执行架构:
触发 → 读取 README 🤖 导航块 → 定位状态文件 → Git 分析 → 双域检查 → 报告 → 自动文档更新 → 开发者上下文输出
双域检查系统(Polycentric Governance):
| 类型 | 文件 | 执行者 | 特性 |
|------|------|--------|------|
| 解释性 | `checks/**/*.md` | AI | 始终通过,AI 阅读后按规则行动 |
| 确定性 | `checks/**/*.sh` | Bash | 通过/失败,exit code 决定 |
| 层级 | global + local | — | local 冲突时优先 |
显著优点
1. 代谢成本归零:首次配置后,每次会话零解释开销,AI 自主读取伦理与协议
2. 防漂移架构:强制文档-代码-路线图三方对齐,mermaid 图表自动同步至所有状态文件
3. 五级状态机:🛑 Failed / ⚠️ Mismatch / 🧑 Grooming / ✅ In Progress / 🎉 Complete 清晰界定工作边界
4. 通用无侵入:通过 README 导航块自发现路径,零硬编码,可复制到任何项目
5. 开源可审计:MIT 协议,检查规则可自定义,支持团队共享 backstage 协议仓库
潜在局限与风险
权限敏感性:
- 从 GitHub 拉取远程代码执行
- 修改项目文件(README/ROADMAP/CHANGELOG)
- 依赖 rsync 进行更新
- 明确警告:不推荐用于不受信任的第三方项目
运维负担:
- 需要维护
checks/目录的 global/local 分层 - 路线图解析脚本和 mermaid 生成规则需要手工同步
- 复杂项目的检查冲突需要人工裁决
边缘场景:
- 无 Git 仓库、无 README、损坏的状态文件会导致流程中断
- 离线环境下无法更新上游检查规则
适合人群
- 个人开发者:管理多个 side project,需要快速上下文切换
- 小型信任团队:共享 backstage 协议仓库,统一开发节奏
- AI 工作流重度用户:愿意前期投资结构化配置,换取长期零摩擦委托
常规风险
| 风险 | 缓解措施 |
|------|---------|
| 恶意上游代码 | 仅用于个人/信任团队;更新前人工确认 |
| 自动修改导致数据丢失 | Git 历史保留,全部变更可回滚 |
| 检查规则误报/漏报 | local 检查可覆盖 global,人工最终裁决 |
| 权限提升滥用 | 明确声明 admin 工具属性,用户自担风险 |
设计哲学
> "WITHOUT IT: Work happens outside backstage → drift → broken trust → triple metabolic cost"
>
> "WITH IT: 'good morning X' → automatic context load → work inside boundaries → paridade maintained"
这是架构优先(architecture-first)的工作流:先定义边界,再执行工作。不是项目管理工具,而是项目状态的免疫系统。