@ agentworkforce/ persona- kit (英语)

Persona -kit拥有Agent Workforce的人 一个即时生命周期。 见跟踪问题 64号。 。 。 .

顶级管弦乐 API

该套件暴露出两个阶段的API:a 纯计划构建器 组成一个 persona的运行时间数据变为单一可检查值,a 副作用 执行器 运行计划并返回一个反转每个侧的控点 效应.

Persona JSON — 运行中的代理( 端到端)

import {
  buildPersonaSpawnPlan,
  executePersonaSpawnPlan,
  type ResolvedPersona
} from '@agentworkforce/persona-kit';
import { spawn } from 'node:child_process';

declare const persona: ResolvedPersona; // from loadPersonas() / personaCatalog

// 1. Compose a plan. Pure — no I/O, no subprocesses.
//    PlanOptions: inputValues, envOverrides, processEnv, installRoot.
//    cwd belongs to ExecuteOptions, not the plan builder.
const plan = buildPersonaSpawnPlan(persona, {
  inputValues: { TASK: 'tidy up the README' }
});

// 2. Inspect or stamp the plan if you like — it's JSON-serializable.
console.log(plan.cli, plan.args, plan.env);

// 3. Run the side effects. Returns a handle whose dispose() reverses them.
const handle = await executePersonaSpawnPlan(plan, { cwd: process.cwd() });

try {
  // 4. Spawn the harness at handle.cwd with plan.cli + plan.args + plan.env.
  await new Promise<void>((resolve, reject) => {
    const child = spawn(plan.cli, plan.args, {
      cwd: handle.cwd,
      env: plan.env,
      stdio: 'inherit'
    });
    child.on('error', reject);
    child.on('close', () => resolve());
  });
} finally {
  // 5. Tear down: removes installed skills, restores sidecar files,
  //    cleans up materialized config files, releases the mount.
  await handle.dispose();
}

计划结构

PersonaSpawnPlan 随心所欲,随心所欲

• persona - 决心的人a(模型、用具、技能、入门、.).
• cli, (中文(简体) ), args, (中文(简体) ), initialPrompt - 什么产物.
• env ——有输入绑定的最后一个环境 + persona env 合并入.
• skills - 纯度 SkillMaterializationPlan 生产 materializeSkills。 。 。 .
• mount, (中文(简体) ), sidecars, (中文(简体) ), configFiles, (中文(简体) ), inputs - 已解决的部分准备就绪 执行者.

计划是 JSON 连续 – 可用于被印入发射元数据 或通过电线发送(例如继电器) getPersonaSpawnPlan) (中文(简体) ).

分块帮助

对于想要自己的管弦乐的召唤者:

• applyPersonaMount(mount, options) - 打开一个 @relayfile/local-mount 提供挂载策略时的沙盒, 否则不能 。 返回一个手柄 暴露绳子 cwd。 。 。 .
• runSkillInstalls(plan, options) − 生成所生成的安装命令 以 buildInstallArtifacts在第一个非零退出时中止并附加 缓冲子进程输出到 SkillInstallError。 。 。 .
• writePersonaSidecars(sidecars, options) 写作 CLAUDE.md 编号 : AGENTS.md 与还原处理语义.
• materializePersonaConfigFiles(configFiles, options) - 写下绳子 配置文件(例如). opencode.json) 有还原处理语义.

每个助手返回形状的控点 { dispose(): Promise<void> }。 。 。 . executePersonaSpawnPlan 编曲顺序:上 技能 侧车 - 配置文件。 如果任何步骤投出,则在LIFO中处理前手柄 在原始错误传播前排列.

纯低级助手

buildInteractiveSpec, (中文(简体) ), materializeSkills, (中文(简体) ), parsePersonaFile, (中文(简体) ), resolvePersonaInputs高级呼叫者如想要,可继续使用,等等 更好的控制 比计划制定者提供.