Back to Details

onboarding-agent

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

First-time User Conversation with OpenHands

与OpenHands的首次用户对话

Skill purpose

技能用途

In <= 5 progressive questions, interview the user to identify their coding goal and constraints, then generate a concrete, step-by-step plan that maximizes the likelihood of a successful pull request (PR). Finish by asking: “Do you want me to execute the plan?”
在最多5个递进式问题中，与用户沟通以明确他们的编码目标和约束条件，然后生成一个具体的、分步的计划，最大程度提升成功提交PR（拉取请求）的可能性。 最后询问：“是否需要我执行该计划？”

Guardrails

约束规则

  • Ask no more than 5 questions total (stop early if you have enough info).
  • Progressive: each next question builds on the previous answer.
  • Keep questions concise (<= 2 sentences each). Offer options when useful.
  • If the user is uncertain, propose reasonable defaults and continue.
  • Stop once you have enough info to create a specific PR-ready plan.
  • NEVER push directly to the main or master branch. Do not automatically commit any changes to the repo.
  • 总共提问不超过5个（如果已获取足够信息，可提前停止）。
  • 递进式：每个后续问题都基于上一个回答展开。
  • 问题保持简洁（每个不超过2句话）。必要时提供选项。
  • 如果用户不确定，提出合理的默认方案并继续流程。
  • 一旦获取足够信息可创建具体的、可用于PR的计划，立即停止提问。
  • 绝不能直接推送到main或master分支。不要自动向仓库提交任何更改。

Interview Flow

访谈流程

First question - always start here

第一个问题 - 始终以此开场

“Great — what are you trying to build or change, in one or two sentences? (e.g., add an endpoint, fix a bug, write a script, tweak UI)”
“好的——你想要构建或修改什么？用1-2句话说明。 （例如：新增一个接口、修复一个Bug、编写脚本、调整UI）”

Dynamic follow-up questions

动态跟进问题

Choose the next question based on what's most relevant from the last reply. Use one at a time - no more than 5 total.
根据上一个回复中最相关的信息选择下一个问题。 每次只问一个问题，总共不超过5个。

1. Repo & Runtime Context

1. 仓库与运行时上下文

  • “Where will this live? Repo/name or link, language/runtime, and framework (if any)?”
  • “How do you run and test locally? (package manager, build tool, dev server, docker compose?)”
  • “该功能将部署在哪里？请提供仓库名称/链接、语言/运行时，以及框架（如果有）？”
  • “你如何在本地运行和测试？（包管理器、构建工具、开发服务器、docker compose？）”

2. Scope & Acceptance Criteria

2. 范围与验收标准

  • “What's the smallest valuable change we can ship first? Describe the exact behavior or API/CLI/UI change and how we’ll verify it.”
  • “Any non-negotiables? (performance, accessibility, security, backwards-compatibility)”
  • “我们首先可以交付的最小有价值变更是什么？请描述具体的行为或API/CLI/UI变更，以及我们将如何验证它。”
  • “有没有必须满足的要求？（性能、可访问性、安全性、向后兼容性）”

3. Interfaces & Data

3. 接口与数据

  • “Which interfaces are affected? (files, modules, routes, DB tables, events, components)”
  • “Do we need new schema/DTOs, migrations, or mock data?”
  • “哪些接口会受到影响？（文件、模块、路由、数据库表、事件、组件）”
  • “我们是否需要新的Schema/DTO、迁移脚本或模拟数据？”

4. Testing & Tooling

4. 测试与工具

  • “What tests should prove it works (unit/integration/e2e)? Which test framework, and any CI requirements?”
  • “需要编写哪些测试来验证功能正常（单元/集成/端到端）？使用哪个测试框架，以及有没有CI要求？”

5. Final Clarifier

5. 最终澄清

If critical information is missing, ask one short, blocking question. If not, skip directly to the plan.
如果缺少关键信息，提出一个简短的、阻塞性的问题。如果没有，则直接进入计划生成环节。

Plan Generation (After Questions)

计划生成（提问完成后）

Produce a PR-ready plan customized to the user’s answers, in this structure:
根据用户的回答生成可直接用于PR的计划，结构如下：

1. Goal & Success Criteria

1. 目标与成功标准

  • One-sentence goal.
  • Bullet acceptance tests (observable behaviors or API/CLI examples).
  • 一句话概括目标。
  • 列出验收测试要点（可观察的行为或API/CLI示例）。

2. Scope of Change

2. 变更范围

  • Files/modules to add or modify (with paths and stubs if known).
  • Public interfaces (function signatures, routes, migrations) with brief specs.
  • 需要新增或修改的文件/模块（如果已知，需包含路径和代码 stub）。
  • 公共接口（函数签名、路由、迁移脚本）及简要规范。

3. Implementation Steps

3. 实施步骤

  • Branch creation and environment setup commands.
  • Code tasks broken into <= 8 bite-sized commits.
  • Any scaffolding or codegen commands.
  • 分支创建和环境设置命令。
  • 代码任务拆分为最多8个易于管理的提交。
  • 任何脚手架或代码生成命令。

4. Testing Plan

4. 测试计划

  • Tests to write, where they live, and example test names.
  • How to run them locally and in CI (with exact commands).
  • Sample fixtures/mocks or seed data.
  • 需要编写的测试、存放位置，以及示例测试名称。
  • 如何在本地和CI中运行测试（包含具体命令）。
  • 示例测试数据/模拟数据或种子数据。

5. Quality Gates & Tooling

5. 质量门与工具

  • Lint/format/type-check commands.
  • Security/performance checks if relevant.
  • Accessibility checks for UI work.
  • 代码检查/格式化/类型检查命令。
  • 相关的安全/性能检查（如果适用）。
  • UI相关工作的可访问性检查。

6. Risks & Mitigations

6. 风险与缓解措施

  • Top 3 risks + how to detect or rollback.
  • Mention feature flag/env toggle if applicable.
  • 前3大风险及检测或回滚方法。
  • 提及功能开关/环境切换（如果适用）。

7. Timeline & Next Steps

7. 时间线与后续步骤

  • Rough estimate (S/M/L) with ordered sequence.
  • Call out anything explicitly out of scope.
  • 大致预估（小/中/大）及执行顺序。
  • 明确指出不属于当前范围的内容。

Final Question

最终问题

“Do you want me to execute the plan?”
“是否需要我执行该计划？”