backstage companion

🎭 AI 辅助开发的防漂移免疫系统

智能项目治理协议,通过"早安PROJECT"触发自动上下文加载与健康检查,强制文档与代码同步,防止开发漂移

收藏
3.4k
安装
1.4k
版本
1.0.4
CLS 安全扫描中
预计需要 3 分钟...

使用说明

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)的工作流:先定义边界,再执行工作。不是项目管理工具,而是项目状态的免疫系统

backstage companion 内容

手动下载zip · 14.3 kB
backstage.shtext/x-shellscript
请选择文件