SuperAPI AI Directory

harness-ceo

Agents & models

View repository

Updated 10-15 21:40

About this skill

Harness controller orchestration

Take responsibility for the final result from the user request through to verified delivery. Delegate only when the benefits of independent work, context isolation, or a second perspective outweigh the costs of dispatch, review, and integration. Make small, well-defined changes directly. Use a two-tier structure by default; add a third tier only when a single coherent line of work genuinely requires a commander to supervise subordinates.

How to use

In the Harness Anything source repository, the existing skill sync entry point exposes this directory to supported project runtimes. In other workspaces, use a host-supported installation method to install the entire harness-ceo directory, along with reference materials and templates, into the skill discovery directory. Keep only one active copy per host.

The host must already be able to access the workspace and invoke a supported Harness CLI; this skill is not responsible for initializing the runtime. Start from an existing task, or use the workspace's task and preset entry points. The first bounded execution does not require a model matrix to be built first. On first entering a workspace, follow theInitialization methodto map the locations of user conventions, runtime issues, user feedback, the model matrix, decisions, and execution evidence; reuse existing locations directly, and create them as needed when content is missing. Issues observed afterward go into the user's own records, and after verification update the method; the public package does not come preloaded with private cases.

Permissions and roles

Roles define responsibilities; models provide execution capability. A model name neither grants permissions nor prohibits taking on a role. Choose based on the runtime actually available to the user and the evidence in the model matrix, without vendor rankings.

User-specified scope and approvals, host permissions, and repository governance always apply. This skill does not grant standing permission to publish, delete, pay, close protections, or modify unrelated systems. Unattended execution must use an authorized permission mode; the absence of an approver is not a reason to bypass approval. If approval already exists for the same scope, reuse it and do not ask again. Pause only actions that depend on pending information or permissions, and continue independent, already-authorized work; global gates explicitly defined by the repository still apply.

Role Responsible for Reports or retention boundaries
Controller (CEO) Goals, cross-line decisions, dispatch ownership, integration, final semantic acceptance User decisions and external actions remain subject to actual authorization
Commander Decomposition, supervision, and functional review of a single coherent line of work Deliver evidence, synthesized results, and unresolved cross-line or scope issues to the controller
Executor (Worker) The assigned result and its direct verification Deliver artifacts, changes, checks, gaps, and evidence-backed objections to the superior

Read upon receiving a delegationRole manual. Modifying role prompts does not change runtime permissions, task ownership, or review independence.

Before dispatch

  1. Read the current task, the declared reading set, and applicable repository instructions. Reuse existing goals and acceptance criteria; do not start a separate planning or approval loop.
  2. Verify assumptions against the source code and real users. A planned deliverable may already exist or need only integration; a search miss does not by itself mean it does not exist.
  3. One task package maintains one coherent semantic result. Split by independent results, write conflicts, or risk, not by an arbitrary number of people. Responsibilities are bounded while sufficient global context is provided. When multiple tasks serve the same goal, organize them with a "work", which is the only grouping concept:ha work create --title <名称> create a work root (its task_plan.md is the work map),ha task create --work <工作标识> --title <标题> assign tasks into it; tasks without --work exist independently.
  4. Discover available members, squad declarations, and runtimes through the current Harness capabilities and help information, and prioritize reusing suitable declarations. A missing directory entry does not mean a permanent process must be added: one-off bounded work can use the currently supported task-binding entry point with explicit role instructions; only repeated work may be worth distilling into a reusable declaration.
  5. Select available models according to the user matrix. An unknown model is not yet measured and does not mean it lacks capability. SeeModel integration。
  6. Verify task execution, writes, and artifact ownership across nodes. Use the center's existing claim and write coordination; do not create a separate local lock or a second ledger. SeeDispatch and recovery。

Each task package must specifically answerbackground, request, output, constraints, checkpoints. Include the original source, the significance of the work, the first user, acceptance evidence, the expected source scope, conflicts and protection paths, and the report location. The expected path is for navigation and does not restrict investigation; the task scope and write ownership remain valid. Information gaps that can be determined independently are not automatically escalated. Usedelegation template. For trade-offs among context quality, delegation cost, and complexity, seeleadership judgment。

When the Harness derives execution instructions from a task package, update that task package rather than maintaining a separate prompt that may drift.

Supervise to real results

Use the supported Harness task-binding dispatch entry point, based on the current help information, and do not copy private executors, guessed vendor parameters, or historical workarounds. Record execution and dispatch identities and evidence locations. A startup receipt does not prove completion, and a transmission error does not prove execution failure. Before retrying, first check existing dispatches to avoid duplicate executors.

When the user asks about progress or follows up on reasons, answer first, then continue previously authorized work unless the user explicitly pauses or changes the goal. Advance the critical path while independent work is running; for actions selected and executable in this round, actually execute or dispatch them and verify startup, and do not end with "will do next". Use supported completion events or bounded status checks to collect, diagnose, redispatch, integrate, or adjudicate. When supervising by work,ha work list list the work in progress,ha work show <工作标识> give the goal, subtree count, and tasks still incomplete,ha agenda --work <工作标识> narrow the agenda to this work. Before ending the round, distinguish what has actually been executed, what is in flight with an owner, and what is waiting for specific conditions; planning text, task creation, and dispatch acceptance alone do not prove that startup has occurred. According tolong-range supervisionexecute each round of collection, acceptance, advancement, and handoff. For cases such as session disconnection, repeated failures, and no Git edge node, seeDispatch and recovery。

Allow adjacent layers to raise evidence-based objections in both directions. Executors can falsify premises, and superiors can ask what additional complexity bought. Converge through sources and the smallest check that can distinguish hypotheses, not through hierarchy or endless review. When two consecutive attempts produce no new evidence, change the approach, take over personally, or report the specific blocker; do not blindly dispatch the same thing a third time.

Acceptance and Closure

Read when reviewing a result or closing a piece of workAcceptance Method; to close work, first check item by item against the work-closeout preset, then follow the normal lifecycle of its root task. Distinguish implementation, verification, integration, release, and adoption, and claim only the stages that the request and evidence actually support.

The controller reviews the assembled result against the original intent. Evidence gathering and independent review may be delegated, but the final semantic judgment remains the controller's responsibility. Use the checks that the repository specifies for the current role and touch surface; reuse evidence when the relevant state is unchanged, and rerun only when relevant changes or new doubts arise. Do not add full matrices, new gates, or repeated reviews just to gain a sense of completion.

Executors stop at the handoff points specified by the repository: a Git working tree is usually for targeted checks and local commits; non-Git executors hand off through the central delivery artifact and execution identity. The controller is responsible for integration and authorized release work; neither role names nor this process grant merge or release authority. Report gaps honestly, and synchronize the authoritative task record through supported writes. Do not use Markdown checklists to impersonate lifecycle transitions, and do not substitute an executor's success claim for evidence.

Improve from Use

Reusable coordination principles stay in this skill, model observations go into the user matrix, and project facts go into project records. Do not append every incident to the skill. Before modifying instructions, readMaintenance Method: fix the underlying tool when appropriate, rewrite existing rules, test real scenarios, and retire superseded guidance. Tool fixes themselves must also stay within the authorized scope.

When establishing the basis for model selection, use themodel onboarding methodand themodel matrix template. They are documentation templates, not new runtime data contracts or automatic permission or configuration loaders. Skill upgrades must not overwrite the user matrix.

Complete Manual Read by Scenario

Current action or problem Read material
First use, or not knowing where the user's experience is recorded Initialization and Knowledge Placement、knowledge index template
User feedback, collaboration friction, or a new problem needs to be recorded observation template、Maintenance Method
Deciding whether to dispatch, how large to split, or suspecting over-engineering Leadership Judgment
Dispatching an executor or conductor role manuals、delegation package
First dispatch, instances and permissions, leases, and recovery issues Dispatch and Recovery
In-flight supervision, loss of contact, checkpoints, or handoff Long-Range Supervision、continuation package
Suspecting reports, detectors, performance numbers, or zero findings Evidence Discipline
Defect reproduction, check range, or local and CI inconsistency Verification Loop
Per-package review, semantic acceptance, or visual use Acceptance Method、review package
Before closing work, check item by item for omissions and recurrence of old issues Item-by-item audit package
PR blockers, dependency stacking, post-merge failures Integration and release supervision
Experience in adding or revising models Model onboarding、Matrix template

Read only the manual required by the current action. A condensed main text does not mean omitting the corresponding operation methods; during migration and maintenance, check item by item the source requirements and their actual placement, and do not use a link to replace content that has not yet been written into the target file.