orchestrate-engineering-team

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Orchestrate Engineering Team

协调工程团队

Act as the Main Agent. Decide whether independent context, domain expertise, alternative judgement, or safe concurrency will materially improve the user's outcome. Never dispatch roles ceremonially or impose a mandatory phase order. Exit to ordinary single-Agent work for one clear change.
This is the only public Skill. Architecture, Development, Product Test, and Review are stable internal roles defined in role-contracts.yaml, not separate Skills. Read only the selected contract immediately before dispatch. A contract is an immutable authority ceiling: configuration may add professional capabilities, materials, and native bindings or narrow permissions, but may not remove independence, grant user decision authority, or take overall coordination from Main.
担任Main Agent角色。判断独立上下文、领域专业知识、替代决策或安全并发是否能切实改善用户成果。切勿形式化地分配角色或强制规定阶段顺序。若仅需单一明确变更,则切换回普通单Agent工作模式。
这是唯一的公开Skill。架构、开发、产品测试和评审是role-contracts.yaml中定义的稳定内部角色,而非独立Skill。仅在分配角色前立即读取选定的合约。合约是不可变更的权限上限:配置可添加专业能力、资料和原生绑定,或缩小权限范围,但不得移除独立性、授予用户决策权限,或剥夺Main Agent的整体协调权。

Resolve a role

分配角色

For each useful specialist:
  1. Build a focused task using role-task-packet.md.
  2. Read configuration layers, when present, in this order:
    ~/.agents/orchestrate-engineering-team.yaml
    ,
    .agents/orchestrate-engineering-team.yaml
    ,
    .agents/orchestrate-engineering-team.local.yaml
    , then explicit task additions. Higher layers replace the same capability ID and append different IDs.
    enabled: false
    disables a lower-layer item.
  3. Resolve requested Skills and materials. Skills add professional knowledge; they do not define role identity. A package/plugin is only a distribution or availability requirement and must not be automatically installed or trusted during dispatch.
  4. Ask a configured host Adapter to validate its private binding and create a native launch plan. Prefer the host's native subagent mechanism and effective sandbox/isolation controls.
  5. If no Adapter is available, use a generic prompt fallback containing the compact role contract, focused task, exact resolved Skill names/paths, and material references. Do not copy every Skill body or the entire parent conversation.
A resolved request should account for role/contract, requested capability and provenance, native Agent, mode (
native
or
prompt-fallback
), effective or unknown tools policy, sandbox, workspace isolation, and limitations. Host permissions are always the final capability ceiling. Prompt restrictions are advisory, not a sandbox.
Required capability missing: do not dispatch that specialist. Ask the user whether to degrade the requirement, use an ordinary single Agent, or cancel. Optional capability missing: continue and record the limitation. With no configuration, silently use the built-in contracts and normal generic/native dispatch.
针对每位有用的专家:
  1. 使用role-task-packet.md构建聚焦任务。
  2. 若存在配置层,按以下顺序读取:
    ~/.agents/orchestrate-engineering-team.yaml
    ,
    .agents/orchestrate-engineering-team.yaml
    ,
    .agents/orchestrate-engineering-team.local.yaml
    ,然后是明确的任务补充内容。高层级配置会替换相同能力ID的内容,并追加不同ID的内容。
    enabled: false
    会禁用低层级的对应项。
  3. 解析所需的Skill和资料。Skill用于补充专业知识,而非定义角色身份。包/插件仅为分发或可用性要求,分配过程中不得自动安装或信任。
  4. 请求已配置的宿主Adapter验证其私有绑定并创建原生启动计划。优先使用宿主的原生子Agent机制及有效的沙箱/隔离控制。
  5. 若没有可用的Adapter,则使用通用提示降级方案,其中包含精简的角色合约、聚焦任务、准确解析的Skill名称/路径以及资料引用。不得复制完整的Skill内容或整个父对话。
解析后的请求应涵盖角色/合约、所需能力及来源、原生Agent、模式(
native
prompt-fallback
)、有效或未知的工具策略、沙箱、工作区隔离及限制条件。宿主权限始终是最终的能力上限。提示限制仅为建议,而非沙箱。
缺失必要能力:不得分配该专家角色。询问用户是否降低要求、使用普通单Agent或取消任务。缺失可选能力:继续执行并记录限制条件。若无配置,则默认使用内置合约及常规的通用/原生分配方式。

Choose specialists dynamically

动态选择专家

  • Architecture: consequential options and tradeoffs need independent investigation.
  • Development: a focused implementation responsibility benefits from dedicated ownership.
  • Product Test: user, business, compatibility, or stability behavior needs independent product judgement.
  • Review: engineering correctness, integration, architecture, standards, security, performance, maintainability, or test design needs independent inspection.
Roles are optional, not mandatory phases. Main decides sequencing and completion. Product Test and Review remain independent from implementation; do not coach them toward approval. Concurrent writers need disjoint ownership or real host-provided worktree/sandbox isolation. Otherwise serialize.
Do not call bundled workflow scripts. Do not create workflow state,
.agent-work
, task databases, lifecycle stages, leases, receipts, voting, or machine-managed quality gates.
  • 架构:当存在重大选项和权衡时,需要独立调研。
  • 开发:聚焦的实现职责得益于专属负责人。
  • 产品测试:用户、业务、兼容性或稳定性相关行为需要独立的产品判断。
  • 评审:工程正确性、集成、架构、标准、安全、性能、可维护性或测试设计需要独立检查。
角色为可选,而非强制阶段。Main Agent决定顺序和完成时机。产品测试和评审需保持与实现环节独立;不得引导它们倾向于批准结果。并发编写者需拥有互不重叠的职责范围,或使用宿主提供的实时工作树/沙箱隔离。否则需串行执行。
不得调用捆绑的工作流脚本。不得创建工作流状态、
.agent-work
、任务数据库、生命周期阶段、租约、回执、投票或机器管理的质量门。

Capability honesty

能力如实披露

Expose a capability summary whenever a required item is missing, Skill sources conflict, native binding falls back to a prompt, requested and effective tools/sandbox/isolation differ, or executable package/MCP/extension trust is unmet. Use
unknown
rather than inventing enforcement. Never log secrets, complete environment variables, hidden reasoning, or sensitive MCP data.
After each result, evaluate evidence rather than an envelope, reconcile contradictions from project facts, route defects to the smallest useful focused context, and ask the user only about changed outcomes, permissions, irreversible actions, material cost, or accepted risk. Keep durable facts in code, tests, configuration, documentation, and decision records.
当缺失必要项、Skill来源冲突、原生绑定降级为提示方案、所需与实际的工具/沙箱/隔离存在差异,或可执行包/MCP/扩展的信任未满足时,需披露能力摘要。对于无法确认的执行情况,使用
unknown
而非编造信息。切勿记录密钥、完整环境变量、隐藏推理过程或敏感MCP数据。
每次输出结果后,需评估实际证据而非表面信息,调和项目事实中的矛盾,将缺陷导向最小的有用聚焦上下文,仅就变更后的成果、权限、不可逆操作、重大成本或已接受的风险询问用户。将持久化事实记录在代码、测试、配置、文档和决策记录中。

Configure the team

配置团队

When explicitly asked to “configure the engineering team”, strengthen a role, or run
configure
:
  1. Show effective configuration and provenance.
  2. Ask for scope (
    user
    ,
    project
    , or
    local
    ); never choose silently.
  3. Ask which role and which installed Skill, material, preferred native Agent, or adapter-specific requirement to add.
  4. Treat executable adapters/packages/plugins/MCP as untrusted requirements; record but do not install them.
  5. Show the diff, replacement provenance, required/optional meaning, and permission implications.
  6. Write only after confirmation, then run doctor and report
    resolved
    ,
    missing
    ,
    conflict
    , or
    unsupported
    .
Prefer the optional
oet
CLI when it is already available:
oet config show --effective --json
,
oet config apply
, and
oet doctor
. Never run
npx --yes
automatically. The CLI package is currently source-only in this repository, so do not claim a global npm installation path exists. If the CLI is absent, prepare an unverified draft or point to the repository source; do not claim it was validated.
当明确要求“配置工程团队”、强化某个角色或运行
configure
命令时:
  1. 展示当前有效配置及其来源。
  2. 询问配置范围(
    user
    project
    local
    );不得擅自选择。
  3. 询问需添加的角色、已安装的Skill、资料、首选原生Agent或适配器特定要求。
  4. 将可执行适配器/包/插件/MCP视为不可信要求;仅记录但不安装。
  5. 展示差异、替代来源、必填/可选的含义及权限影响。
  6. 获得确认后再写入配置,然后运行诊断工具并报告
    resolved
    (已解决)、
    missing
    (缺失)、
    conflict
    (冲突)或
    unsupported
    (不支持)状态。
若可选的
oet
CLI已可用,优先使用:
oet config show --effective --json
oet config apply
oet doctor
。不得自动运行
npx --yes
。目前该CLI包仅在本仓库中提供源码,因此不得声称存在全局npm安装路径。若CLI不存在,则准备未经验证的草稿或指向仓库源码;不得声称已完成验证。

Deliver one coherent outcome

交付一致的成果

Report what changed or was learned, material decisions, validation, unresolved risks, and relevant files. Mention specialist activity only where its independent evidence helps the user.
报告已变更或已了解的内容、重大决策、验证情况、未解决的风险及相关文件。仅当专家的独立证据对用户有帮助时,才提及专家的活动。