Skip to content

ArchSpine 战略

ArchSpine 的定位是 AI 辅助工程的语义控制面。它不是“把文档做得更漂亮”的工具,而是把仓库结构显式化、可查询化、可治理化。

问题是什么

大型仓库会以非常稳定的方式失序:

  • God file 吞掉越来越多逻辑
  • 职责跨层扩散
  • 历史设计意图随着团队流动而消失

传统 prompt 驱动的 AI 工作流会放大这个问题,因为它把“理解仓库”变成了一次临时重建。

核心判断

ArchSpine 用三件事来解决这个问题:

  1. 确定性提取
  2. 显式治理
  3. 可持久化的语义记忆

确定性提取

以 AST 结构为稳定基础,避免 Agent 在语法和依赖上盲猜。

显式治理

让团队在 .spine/rules/ 中声明规则,再基于这些规则进行审计和修复。

语义记忆

把角色、职责和 drift 信息持久化,让仓库意图不依赖单个开发者记忆存在。

执行模型

运行时实现也必须和战略保持一致:

  • pipeline 各阶段要使用显式的输入 / 输出契约
  • 共享运行态要保持足够窄且可读
  • 临时产物要和 telemetry 分开
  • 编排逻辑应放在 service 层,而不是泄漏进 task 内部

这样 ArchSpine 才能在保持 CLI-first 可用性的同时,对未来的 MCP 或 daemon 入口仍然保持确定性和可治理性。

Open core 边界

开源层:

  • .spine 协议
  • extractors
  • 基础 CLI
  • 本地聚合
  • 本地 MCP 支持

如果后续有商业层,重点应该放在组织级控制面价值,而不是基础仓库生成能力。

战略护城河

ArchSpine 进入的是四个高价值工作流位置:

  1. commit 时的同步和仓库卫生
  2. CI / PR 阶段的治理
  3. 通过 MCP 为 Agent 提供上下文
  4. 新成员 onboarding 和仓库理解

长期目标

.spinepackage.json 一样,成为 AI 可读仓库中的自然标准。

相关文档

English is the primary docs tree; zh-CN mirrors shipped behavior.