Connect existing systems, project graphs, and Readiness
Product documentation · Simplified Chinese
This guide is currently available in Simplified Chinese.
接入已有系统后，先确认软件工厂读取的是正确工程，再使用项目图谱、Readiness 和 Spec 构建理解系统。当前仓库、运行配置和实际执行结果是核对系统行为的依据。
连接正确的工程
由具备配置权限的成员创建或编辑工作空间，关联已有应用或外部代码库，核对测试分支、生产分支和执行资源。
详细步骤见管理员配置指南。完成配置后，研发人员还需验证仓库访问、依赖安装、启动、构建与测试，不能仅凭关联成功判断工程可用。
阅读项目图谱
在工作空间中打开 “项目图谱”，检查页面显示的生成状态和可用结果。没有结果或生成失败时，先查看提示，再决定是否重新生成。
从系统结构开始，逐步查看模块和依赖关系，结合仓库中的实际目录、配置和接口核对关键链路。图谱可以帮助定位线索，自动识别的关系仍可能存在遗漏。
建议记录三个问题：本次需求涉及哪些模块，依赖哪些外部系统，哪些关键关系还需要研发或业务负责人确认。
阅读 Agent Readiness
从工作空间的 Agent Readiness 入口查看审计页面，按页面操作发起审计或阅读已有结果。
先看报告对应的工程与时间，再看具体检查项、失败原因和改进建议。总分用于概览，判断能否开展本次工作时，应检查实际涉及的条件。
Readiness 不等于业务验收结果。没有报告，也不能直接推断工程已经失败或已经通过。
从已有工程构建 Spec
进入工作空间的 Spec 区域，打开构建入口。当前提供 全量构建 和 增量构建，用于首次梳理以及后续变化整理。
- 确认工作空间和仓库已准备好，选择适合本次范围的构建方式。
- 查看构建进度、所用分支与提交，以及错误或警告。
- 逐项审阅生成的变更内容，核对业务含义、来源与当前实现。
- 构建达到“待发布”状态且内容经过确认后，点击 “审核并发布”。
- 返回 Spec 列表检查结果，核对范围和来源是否符合预期。
构建结果中的未知或冲突需要保留并核实。发布 Spec 不会部署应用，也不代表本次业务需求已通过验收。
把理解结果用于下一次工作
将已确认的系统边界、接口约束和待解决问题带入需求或技术设计。历史图谱、审计报告和 Spec 可以补充上下文，实际修改前仍应重新检查当前仓库。
资产阅读方法见查找、阅读与复用 Spec 资产。运行任务没有继续时，参考任务排查指南。