Before you start
Product documentation · Simplified Chinese
This guide is currently available in Simplified Chinese.
开始使用软件工厂，先确认三件事：你能访问正确的项目，有一项要推进的工作，以及项目已具备这项工作需要的执行条件。
业务人员主要准备业务背景、规则和预期结果；研发人员还需要确认需求项状态与工程条件；成员权限、模型和运行环境通常由相应管理员配置。可以按本次工作的起点，阅读下面对应的部分。
确认账号、组织与工作空间
使用组织提供的访问地址，按页面提示完成登录。首次加入组织时，可能需要管理员添加成员，或通过邀请申请加入并等待审核。
如果从官网的手机号入口登录，按页面要求填写可接收短信的手机号、获取并输入验证码，阅读并同意相关协议后提交。若页面标明演示环境不会真实发送短信，应使用组织提供的正式入口；企业统一登录则按组织的身份验证流程完成。官网账户登录成功后，仍需确认工作台中的组织成员身份和项目授权。
登录后，先检查：
- 当前组织是否正确：确认自己进入了本次工作的所属组织。
- 目标工作空间是否可见：找到对应项目，并核对名称与用途。
- 账号是否具备所需权限：确认自己能够进入需要的功能，并联系负责后续评审或交付的成员。
首页会根据账号持有的角色展示入口。业务人员可以从“系统规划”“需求创建”“问题反馈”开始；具备交付角色的成员还可以进入“技术设计”“生产实施”等工作。切换页面视角不会增加账号权限。
如果工作空间不可见，请让管理员确认组织成员身份和项目访问范围。如果团队尚未建立对应工作空间，由有权限的成员先完成创建与配置，再开始项目内的协作。
准备一项范围清楚的工作
第一次使用时，选择一个可以说明清楚、结果容易检查的目标。你可以先写一段简短描述，在对话中逐步补充细节。
准备需求时，尽量包含以下信息：
- 使用者和场景：谁在什么情况下使用这个功能？
- 当前问题和预期结果：现在怎样处理，希望改善什么？
- 本次范围：先完成哪些内容，哪些内容留到后续？
- 已知规则和限制：有哪些业务规则、数据口径或权限要求？
- 检查方式：用什么例子判断结果符合预期，由谁确认？
例如，“会员活动目标人群筛选”的初始描述可以是：
运营人员需要在活动发布前，按会员等级、地区和最近消费时间筛选目标人群，并查看预计覆盖人数。本期先做条件筛选和人数预估，保存筛选方案留到后续。多个条件同时选择时取交集，没有匹配结果时显示 0 人。消费时间使用哪个数据字段、数据多久更新，还需要和研发确认。最终由运营负责人使用一组约定的样例数据验收。
尚不确定的信息可以直接标记为“待确认”，并说明需要向谁了解。AI 可以帮助整理问题，团队再补充实际规则。
已有文档、页面截图、流程示例和样例数据都可以作为补充材料。提交问题反馈时，则优先准备发生环境、操作步骤、期望结果、实际结果和发生时间，便于后续定位与复现。
按工作入口检查前置条件
在使用 AI 的入口前，需要有可用的模型服务和对应的会话执行环境。在此基础上，不同工作还有各自的准备要求。
如果已经存在对应的交付批次，应进入该批次查看当前进度和可用操作。准备工作时，也可以先阅读核心概念，了解需求项、交付批次与工作流之间的关系。
与管理员确认项目执行条件
如果环境已经由团队配置好，你需要确认自己可以使用对应能力。首次接入项目或准备进入实施时，建议由研发负责人和相应管理员共同检查以下事项。
关联外部代码库时，需要确认仓库地址、访问凭据，以及实际存在且不同的测试分支和生产分支。创建新应用或关联已有应用时，应核对系统识别的环境分支；具体准备方式取决于工作空间采用的接入方式。
仓库接入成功后，还需要分别确认应用能否启动、测试能否执行、目标环境能否发布。首次需求讨论可以先围绕业务材料展开；进入开发和交付时，再按本次范围核对工程条件。
业务人员可以把配置问题交给相应管理员处理。仓库凭据和模型密钥应由负责配置的成员填写到对应设置中。
做一次最小验证
准备好账号、工作空间和业务描述后，可以用一次简短的需求对话检查是否具备开始条件：
- 确认当前工作空间，选择“需求创建”。
- 输入业务背景，请 AI 先整理目标、范围和待确认问题。
- 检查是否收到正常回复，并核对它理解的项目背景、业务规则和本次范围。
这一步验证的是需求会话能够工作。准备进入开发时，还应由研发人员在对应执行环境中检查仓库访问、依赖安装、构建与测试；准备验收或发布时，再确认实际目标环境。
遇到阻塞时先检查什么
- 看不到工作空间或操作入口：先核对当前组织，再请管理员检查角色与项目访问范围。
- 提示没有可用模型，或会话无法启动：保留页面错误说明，请管理员检查模型配置和会话运行服务。
- 技术设计或生产实施列表为空：检查工作空间和筛选条件，再核对需求项是否已准入、是否已加入批次；从首页进入生产实施时，还要检查详细设计是否已审核通过。
- 仓库或执行环境准备失败：请研发人员结合错误检查仓库地址、凭据、分支及环境状态。
- 尚不清楚业务规则：把问题列为待确认事项，找到相应业务负责人，补充后再评审受影响的规格。
联系协助人员时，提供工作空间名称、正在进行的操作、发生时间和完整的页面错误说明，方便对方定位。
账号与项目访问正常、需求会话可用，并且你已经能描述一个具体目标时，就可以开始整理第一个需求了。
还在确定系统范围时，可先阅读系统规划；处理已发生的异常时，参考上报缺陷与查看处理进度。职责与授权的说明见角色、权限与访问范围。