AI INFRASTRUCTURE FIELD MANUAL · 2026

让 AI 开发
有证据链

SpecCenter × OpenSpec × STDD
结合现网服务与 d5-works 后端案例

开始分享 ↓
01

仓库内

意图 · 场景 · 测试 · 代码

02

组织内

评审 · 规格 · 知识 · 权限

03

Agent 侧

检索 · 同步 · 更新 · 回链

目标：每次 AI 生成都可追溯、可评审、可验证SC / OPS / STDD

THE CONTROL GAP

AI 写得更快，
但“为什么这样改”正在丢失

01 / 08
01

上下文漂移

提示词、聊天记录与仓库状态分离；下一位 Agent 不知道已经确认的约束与取舍。

02

评审失焦

评审者只看到 diff，很难区分需求变化、设计决策和实现偏差。

03

验证失真

“测试通过”被误当成“可以上线”；外部依赖和门禁没有证据位置。

下一层 AI 基建：意图 → 证据 → 共享知识 的控制平面CONTROL PLANE

THREE-LAYER CONTRACT

仓库留证，中心共享，
MCP 连接 Agent

02 / 08
REPO-LOCAL

OpenSpec / STDD

SOURCE OF INTENT & EVIDENCE

  • proposal / design
  • spec + Scenario
  • tasks + RED / GREEN
  • tests + code
ORG-WIDE

SpecCenter

SHARED FACT LAYER

  • Change / Review
  • Product Spec
  • RAG Q&A + Sources
  • Project / RBAC
AGENT-SIDE

MCP

CONTROLLED AUTOMATION

  • search / ask
  • create / read
  • upload / update
  • sync status

LIVE DEPLOYMENT

现网已经形成
d5-works 的共享规格面

03 / 08
11项目
53d5-works Changes
66Product Specs
7仓库绑定
10.1.6.99:23333现网服务 · 数据截取于 2026-07-28
SpecCenter 现网 d5-works 仪表盘
d5-works 项目仪表盘：活跃 Change、Review、Product Spec 和待处理状态在同一视图汇聚。
01

Change 状态层

版本、分支、规格、任务状态和仓库绑定集中可见。

看见正在发生什么
02

Review 控制层

baseline 锁定；working 独立更新；新版本是显式事件。

评审对象不漂移
03

Spec 知识层

产品规格跨变更沉淀，保留 Requirement / Scenario 演化。

知识不随分支消失
04

Agent 接入层

RAG 问答给出处，MCP 统一检索、同步和更新。

让 Agent 回到事实

BASELINE-LOCKED REVIEW

同步不能偷换
评审对象

04 / 08
REVIEW CREATED

Baseline snapshot

创建评审时锁定可复现对象。

  • 规格内容
  • 文件版本
  • 评审上下文
→
REPO MOVES

Working snapshot

同步新提交，但不覆盖 baseline。

  • 持续更新
  • 版本独立
  • new version available
→
HUMAN DECIDES

Continue / Refresh

评审者显式决定评旧基线还是切换。

  • 判断可追溯
  • 讨论不漂移
  • 版本变化可解释
AI 可以继续生成；但评审对象的变化必须经过人的显式决定。

MCP CONTROL SURFACE

让 Agent 使用同一套
受控事实接口

05 / 08
POST http://10.1.6.99:23333/api/mcp
Authorization: Bearer osc_***
Accept: application/json, text/event-stream

# stateless Streamable HTTP
# user / project / RBAC remain effective

rule: upload only spec.md
proposal · design · tasks stay in repository
19Tools
4Resources
检索ask · search · get_spec
变更list / create / get / update / delete
规格upload · batch_upload · update_spec
同步import_changes · get_sync_status
API Token 继承用户权限；服务端保存 SHA-256 哈希；原始值只在创建时展示一次。

END-TO-END LOOP

闭环不是“写完代码”，
而是基线已经更新

06 / 08
STEP 01

定义意图

明确 Why、范围、非目标与风险。

proposal + design
STEP 02

写成契约

Requirement / Scenario 给出可判断结果。

spec.md
STEP 03

STDD 实现

Scenario → RED → GREEN → Verify。

tasks + tests + code
STEP 04

合并并归档

实现进入主干，Change 从 active 转为 archive。

merge + archive
STEP 05

更新共享基线

baseline 与 SpecCenter 同步成为下一次变更起点。

baseline + MCP
闭环判定：实现已合并 + 测试可复现 + Change 已归档 + baseline 已更新。CLOSURE CONTRACT

CLOSED-LOOP CASE · AI INFRA

Spring AI 动态刷新：
从运维痛点走到新基线

07 / 08
5Requirements
10Scenarios
15Tasks / 15
35Focused tests
ARCHIVED · VERSION 1spring-ai-dynamic-refresh · SpecCenter 现网已归档
CLOSURE LEDGERENGINEERING LOOP CLOSED
01 / INTENT
API Key、base-url、model 更新无需重启proposal.md + design.md
LOCKED
02 / SPEC
5 Requirements / 10 Scenariosai-model-dynamic-refresh strict validation
VALID
03 / CODE
Provider + volatile 引用 + 原子替换commit 1902cb47 · contained in master
MERGED
04 / PROOF
35 个聚焦测试当前通过provider / image review / content detection
GREEN
05 / BASELINE
Change 归档，能力规格进入基线archive commit 8295fe0b · SpecCenter archived
UPDATED
BEFORE
Nacos
配置变化→启动时创建的
ChatModel 单例
API Key、base-url 或模型变化后必须重启服务。
LIFECYCLE
CONTROL
→
AFTER
RefreshScope
事件→Provider 校验
并重建→volatile
原子替换
新配置无效时保留旧实例；正在执行的 AI 调用不被中断。
闭环结果不是一场讨论，而是下一次变更可以直接依赖的新基线。ARCHIVE → BASELINE

STDD MICRO-CYCLE · WORKS COLLECTION

只讲一个 Scenario，
但把红绿循环讲完整

08 / 08

商品必须按后台配置顺序返回

GIVEN:
  商品 A 的 product_sort = 2
  商品 B 的 product_sort = 1
WHEN:
  调用 POST /collection/detail
THEN:
  productList[0] = 商品 B
AND:
  productList[1] = 商品 A
  响应不暴露 productSort

同一 Scenario 被拆成可执行微步骤

RED
  productList 按关系表排序返回
  前台响应不包含 productSort
VERIFY RED
  前台详情服务测试失败
GREEN
  按 collectionId 查询并构建商品卡片
VERIFY GREEN
  重跑前台详情服务测试

测试直接断言返回顺序

@DisplayName(
  "已发布且过滤后有商品时返回
   按关系排序的商品卡片"
)
getDetail_success()

rels = [P002(sort=1), P001(sort=2)]
assert productCodes == [P002, P001]

SQL 排序，Service 保持顺序传递

SELECT relations
ORDER BY product_sort ASC, id ASC

rels → productIds
productIds → buildProductCardsByIds
productCards → response.productList
REQUIREMENTS8

Collection 的数据、保存、发布与查询契约。

SCENARIOS26

成功路径、校验、状态与过滤边界。

STDD MICRO-STEPS89

RED / GREEN / Verify 过程显式留证。

FOCUSED TESTS31

6 个测试类 · 0 failures · 0 errors。

PRODUCT SPEC works-collection · spec_1uswi34t · SYNCED · openspec strict VALID · baseline UPDATED
REFERENCE LINKS参考地址
分享材料openspec-share.youcaidi.link SpecCenter 内部服务10.1.6.99:23333 OpenSpec 官网openspec.dev