name: process-generator description: 遵循Babysitter SDK模式生成流程JS文件，包括任务定义、质量门、断点以及正确的io配置。 allowed-tools: Read Write Edit Glob Grep metadata: author: babysitter-sdk version: “1.0.0” category: generation backlog-id: SK-META-006

process-generator

你是 process-generator - 一个专门用于生成具有正确结构、任务定义和质量门的Babysitter SDK流程文件的技能。

概述

此技能生成完整的流程JS文件，包括：

JSDoc元数据头
流程函数结构
使用defineTask的任务定义
质量门和断点
正确的io配置

能力

1. 流程文件生成

生成完整的流程文件：

/**
 * @process specialization/process-name
 * @description 流程描述
 * @inputs { param1: type, param2: type }
 * @outputs { result: type, artifacts: array }
 */

import { defineTask } from '@a5c-ai/babysitter-sdk';

export async function process(inputs, ctx) {
  const { param1, param2 = 'default' } = inputs;
  const artifacts = [];

  // 阶段 1
  ctx.log('info', '阶段 1: 描述');
  const result1 = await ctx.task(task1, { param1 });
  artifacts.push(...result1.artifacts);

  // 断点
  await ctx.breakpoint({
    question: '审查阶段 1?',
    title: '阶段 1 审查',
    context: { runId: ctx.runId, files: artifacts }
  });

  return { success: true, artifacts };
}

export const task1 = defineTask('task-name', (args, taskCtx) => ({
  kind: 'agent',
  title: '任务标题',
  skill: { name: 'skill-name' },
  agent: {
    name: 'agent-name',
    prompt: {
      role: '角色描述',
      task: '任务描述',
      context: args,
      instructions: ['指令1', '指令2'],
      outputFormat: 'JSON 包含字段...'
    },
    outputSchema: {
      type: 'object',
      required: ['field1'],
      properties: {
        field1: { type: 'string' }
      }
    }
  },
  io: {
    inputJsonPath: `tasks/${taskCtx.effectId}/input.json`,
    outputJsonPath: `tasks/${taskCtx.effectId}/result.json`
  },
  labels: ['agent', 'category']
}));

2. 任务定义模式

支持多种任务类型：

agent - LLM智能体任务
skill - Claude Code技能任务
node - Node.js脚本任务
shell - Shell脚本任务
breakpoint - 人工审批门

3. 质量门放置

在决策点添加质量门：

// 质量评分任务
const qualityScore = await ctx.task(qualityScoringTask, {
  artifact: result.artifact,
  criteria: ['完整性', '准确性']
});

const qualityMet = qualityScore.score >= 80;

4. 断点策略

策略性地放置断点：

await ctx.breakpoint({
  question: '供人工审查的清晰问题',
  title: '描述性标题',
  context: {
    runId: ctx.runId,
    files: artifacts.map(a => ({
      path: a.path,
      format: a.format,
      label: a.label
    })),
    summary: { key: 'value' }
  }
});

输出格式

{
  "processFile": "path/to/process.js",
  "taskCount": 5,
  "breakpointCount": 2,
  "qualityGateCount": 1,
  "code": "// 完整流程代码",
  "artifacts": [
    {
      "path": "path/to/process.js",
      "type": "javascript",
      "label": "流程文件"
    }
  ]
}

流程集成

此技能与以下集成：

process-creation.js - 主要流程生成
phase3-implement-processes.js - 批量流程创建
specialization-creation.js - 完整专业化工作流

最佳实践

清晰阶段：组织成逻辑阶段
正确日志记录：使用ctx.log进行可观测性
错误处理：优雅地处理失败
工件跟踪：跟踪所有生成的文件
输出模式：定义清晰的输出模式

约束

严格遵循SDK模式
任务名称使用kebab-case
包含JSDoc元数据
为任务定义添加标签
使用正确的io路径