JD E2E Pipeline 与 Space 使用指南
Overview
这是 E2E Pipeline 和 E2E Space 的统一入口。先判断用户是在管理研发 Pipeline，还是把项目适配、部署、发布到 Space；只读取当前场景对应的 Reference，无需切换到其他 Skill。
First Route
| 用户目标 | 读取的 Reference | 本轮边界 |
|---|---|---|
| 初始化项目、提交需求、选择 Pipeline 路线、多仓协作、集成推送或 Pipeline 排障 | references/platform-guide.md | 按用户授权执行对应阶段 |
| 判断项目是否适合 Space，或比较 Agent、Git、ZIP/HTML 来源 | references/space-overview.md | 只做选型和入口说明 |
| Space MCP 未认证、HiOffice 鉴权失败、确认当前 ERP | references/space-auth.md | 只诊断 Agent 到 MCP 的身份链路 |
| 笼统要求“检查、改造并部署当前项目” | references/assessment.md | 只评估并等待确认改造范围 |
| 构建、启动、监听地址、端口或健康检查不符合容器要求 | references/project-adaptation.md | 只做运行时适配 |
| 页面或后端业务需要读取当前 ERP | references/identity.md | 只接入 Space 身份契约 |
| CLI、设备、Webhook 或 WebSocket 不能经过浏览器 SSA | references/ssa-free.md | 只改免 SSA 路由和调用方 |
| 需要跨部署持久化，或要把不可用的远程数据库改为 SQLite | references/sqlite-persistence.md | 只处理持久化改造 |
| 上传当前目录快照，或创建、更新 Deployment | references/deployment.md | 只上传和部署，不发布域名 |
| 申请域名、选择访问策略或正式发布已有 Deployment | references/publishing.md | 只处理域名、策略和发布状态 |
目标足够具体时直接进入对应模块，不先做全仓评估。一次只读取当前模块需要的 Reference。
E2E Pipeline Rules
- 新功能默认选
superpower：brainstorm → plan → code → review；快速提交可用brainstorm → plan → code。 - Bug 排查选
debug-superpower：investigate → trace → validate → fix。 - 单仓从 Code Base 的需求管理进入；业务项目多仓需求从需求交付进入；临时引入其他仓库使用 Hub 跨库模式。
- 多仓库为每个 Code Base 明确
自动、修改或仅检索。修改只是允许写入，不强制修改；仅检索禁止写任务。 - 跨库执行前检查协作契约、仓库任务、边界、交付物和验收方法。
- 不把生成 commit 等同于已经推送分支或创建 Pull Request，也不在子 Pipeline 和集成状态未成功时宣称交付完成。
Space Working Method
Space 的 Agent 部署每轮严格执行：选择一个模块、读取一个 Reference、完成该模块允许的动作、报告并停止。不要在同一轮从代码改造一路执行到上传、部署和域名发布。
三个主要停顿点：
- 改造范围：轻量评估后等待用户确认模块和顺序。
- 上传部署：代码适配和验证完成后，等待用户决定是否上传当前快照。
- 正式发布：没有完整 hostname 和访问策略时，展示候选与
public、authenticated、allowlist，等待用户选择。
用户当前或前序消息已经明确给出的选择就是确认，不重复询问。纯平台任务不扫描或修改仓库；代码模块不调用部署、域名或访问策略工具。
Shared Guardrails
- 先检查当前项目、仓库、分支、模型、阶段、Deployment、域名或参与模式，再执行相应操作。
- 只读检查可以直接进行。提交需求、启动 Pipeline、批准拆分计划、推送代码、上传快照、创建 Deployment、应用域名或改变访问策略需要用户明确请求。
- Space 默认上传当前本地工作区快照，包括未提交修改；只有用户明确选择 Git 时才使用 Git 来源。
- ZIP 通过本地 CLI multipart 上传，不把 ZIP、base64 或大型二进制传给 MCP。
- 不打印、记录或持久化用户 Key、SSA Ticket、Cookie、Agent Bearer 或
me_token。 - 不启动另一个 Agent。插件安装或更新后，需要用户在原客户端新建任务/会话以重新加载 MCP。
- 失败时读取具体阶段和错误，只修复已确认根因；诊断请求不得自动创建新项目、重新部署或发布域名。
- 对可能变化的平台字段和界面，优先读取实时指南；JD 内部 CLI 能力优先通过
o2发现和调用。
Reporting
Pipeline 任务报告入口、路线、仓库和分支、启用阶段、当前状态、参与模式、待确认事项，以及最终 commit、分支、Pull Request 或失败详情。
Space 任务只报告本轮模块、完成内容、验证或平台结果、下一建议；需要用户选择时只提出一个明确问题。