项目业务与应用场景
项目管理系统知道任务进度，AI 编程工具知道代码上下文，但二者彼此割裂。团队需要一套受权限、契约和审批约束的协作链，让 AI 真正进入研发流程而不是停留在聊天窗口。
01AI DELIVERY LOOP
AI 自动化研发闭环平台（AgentX-Harness × 春山）
面向 5-50 人软件团队，将项目任务、研发资料、AI 编程工作区、审核、测试和 Bug 回归连接为可追踪的自动化研发闭环。
React 19Express 5PostgreSQLTypeScriptElectronOpenAPI 3.0/3.1AgentX FASTJSON-RPCZodHMAC-SHA256
任务就是研发入口
项目资料、接口契约、岗位与阶段依赖随任务进入工作区，减少在项目管理、文档与 AI 会话之间反复搬运上下文。
审核与 Bug 属于同一条链
成果、审核、测试与 Bug 关联到原任务，缺陷只回到需要修复的阶段，通过回归后再继续流转。
每次执行都有可追溯依据
文档版本、契约版本、会话、成果和审批记录共同解释一次任务是如何完成的。
BUSINESS FLOW
核心业务链路
从用户进入系统开始，查看业务数据如何经过各环节并形成最终结果。
SYSTEM NODE 01
春山任务中心
沉淀需求、里程碑、阶段任务、成果、审核与 Bug，形成唯一业务状态源。
ENGINEERING DECISIONS
难题如何变成系统能力
从业务约束出发，说明机制为什么成立、边界在哪里。
有门禁的任务状态机
- 难题
- 任务状态变化不等于工作已被验收，前置阶段未完成时不能直接执行下游任务。
- 机制
- 阶段依赖、负责人门禁和审核状态共同控制解锁；退回与 Bug 回归保留原任务关联。
- 结果
- 任务、审核与回归围绕同一业务状态流转，不以界面进度代替真实完成状态。
上下文与契约版本绑定
- 难题
- 资料更新或切换工作区后，执行依据容易与审核时的版本脱节。
- 机制
- 已审核资料按任务隔离同步，绑定 OpenAPI 版本并校验文件大小与 SHA-256；恢复主会话前重新验证权限。
- 结果
- AI 在明确的项目、资料与契约范围内继续任务，成果能够追溯到执行依据。
重复提交不重复产生成果
- 难题
- 网络重试、连续点击与并发更新可能造成重复成果或覆盖较新的状态。
- 机制
- 成果提交以幂等键识别同一次操作，并使用乐观锁约束并发版本。
- 结果
- 同一提交重试保持单一成果记录，版本冲突显式暴露而不是静默覆盖。
高风险动作必须回到请求人
- 难题
- 自动化链路中的写操作需要明确责任边界，不能因为 AI 给出建议就直接执行。
- 机制
- 只读分析使用短期项目委托令牌；草稿、控制和高风险写操作经请求人审批并保留审计。
- 结果
- 分析与执行使用不同授权边界，审批拒绝会阻断相应操作。
展开补充设计与约束
- OpenAPI 契约基线校验路径、方法、operationId、响应和本地引用，识别 V2/V3 变更与破坏性差异，让资料版本约束具体接口而不只是文档名称。
- 固定文档版本、幂等键与乐观锁共同约束成果提交，避免重复操作、并发覆盖和上下游依据漂移。
- 审核通过的需求、UI、接口和测试资料按任务隔离同步，校验文件大小与 SHA-256，并保留受控远程检索兜底。
- 只读分析使用短期项目委托令牌；草稿、控制与高风险写操作必须由真实请求人确认。
PRODUCT EVIDENCE
界面与业务过程
中文内容 · 模拟数据
每份素材单独标注来源：脱敏系统截图展示既有界面，业务演示解释操作链路。所有业务记录、账号、设备与运行数值均为模拟内容，不作为生产指标或真实执行记录。
CAPABILITIES & BOUNDARIES
能力范围与设计边界
以下描述既有项目的能力与约束，不把浏览器模拟运行结果计为生产实测。
01覆盖 5-50 人软件团队协作模型
02阶段任务、成果、审核和 Bug 全链路可追踪
03高风险 AI 写操作强制人工审批