[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6RVRAM5W8DDJ67Q9GMXRPB8":3,"skill-same:01M6RVRAM5W8DDJ67Q9GMXRPB8":68},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":37,"linkOnly":38,"markdownContent":39,"markdownBody":40,"frontMatter":41,"refName":46,"commitSha":47,"skillDirectory":48,"forksCount":49,"repositoryHtmlUrl":50,"repositoryHomepageUrl":51,"ownerHtmlUrl":52,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":53,"install":54,"resources":67},"01M6RVRAM5W8DDJ67Q9GMXRPB8","workflow-runner",null,"在 Claude Code \u002F OpenClaw \u002F Cursor 中直接运行 agency-orchestrator YAML 工作流——无需 API key，使用当前会话的 LLM 作为执行引擎。当用户提供 .yaml 工作流文件或要求多角色协作完成任务时触发。","rzx007\u002FVykor","rzx007","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22313722?v=4","01M6RVGB3GJ05PGEFHQ34TV6T0","Danovan","01M6RVGB7F20SDKPMEN9RS3N0N",3,"MIT","https:\u002F\u002Fgithub.com\u002Frzx007\u002FVykor\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fworkflow-runner\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36],"workflow","runner","workflow runner","openclaw","code","yaml","execution","api","协作","cursor","orchestrator","agency","文件","2026-11-10 10:12:30",false,"---\nname: workflow-runner\ndescription: \"在 Claude Code \u002F OpenClaw \u002F Cursor 中直接运行 agency-orchestrator YAML 工作流——无需 API key，使用当前会话的 LLM 作为执行引擎。当用户提供 .yaml 工作流文件或要求多角色协作完成任务时触发。\"\nversion: \"1.0.0\"\nlicense: MIT\nmetadata:\n  hermes:\n    tags: [execution, workflow]\n---\n\n# 工作流执行器：在 AI 工具内运行多角色编排\n\n直接在当前会话中执行 agency-orchestrator 的 YAML 工作流，无需配置 API key。当前 LLM 就是执行引擎——依次扮演每个角色完成任务。\n\n## 适用场景\n\n- 用户提供了一个 `.yaml` 工作流文件（如 `运行 workflows\u002Fstory-creation.yaml`）\n- 用户要求多个角色协作完成任务（如\"用产品经理和架构师一起评审这个 PRD\"）\n- 用户安装了 `agency-agents-zh` 并希望直接在 AI 工具内编排多角色\n\n## 执行流程（5 步）\n\n按以下顺序执行，不要跳步：\n\n### 第 1 步：解析工作流\n\n用 Read 工具读取用户指定的 YAML 文件，提取以下字段：\n\n```yaml\nname: \"工作流名称\"\nagents_dir: \"agency-agents-zh\"    # 角色定义目录\ninputs:                            # 输入变量\n  - name: xxx\n    required: true\u002Ffalse\n    default: \"默认值\"\nsteps:                             # 执行步骤\n  - id: step_id\n    role: \"category\u002Fagent-name\"    # 角色路径\n    task: \"任务描述 {{变量}}\"       # 支持模板变量\n    output: variable_name          # 输出变量名\n    depends_on: [other_step_id]    # 依赖关系\n```\n\n**忽略 `llm`、`concurrency`、`timeout`、`retry` 配置**——Skill 模式使用当前会话的 LLM，这些字段仅用于 CLI 模式。\n\n**定位角色目录**：用 Bash `test -d` 按以下顺序检查，用第一个存在的：\n1. 当前工作目录下的 `{agents_dir}\u002F`（如 `.\u002Fagency-agents-zh\u002F`）\n2. `..\u002F{agents_dir}\u002F`（上级目录）\n3. 相对于 YAML 文件所在目录的 `{agents_dir}\u002F`\n4. `node_modules\u002Fagency-agents-zh\u002F`\n\n如果全部找不到，**停止执行**并提示用户：\n```\n找不到角色目录。请先安装：\n  git clone --depth 1 https:\u002F\u002Fgithub.com\u002FjnMetaCode\u002Fagency-agents-zh.git\n  或：npm install agency-agents-zh\n```\n\n### 第 2 步：收集输入\n\n- 对每个 `required: true` 的输入，检查用户消息中是否已提供值\n- 未提供的必填输入：**立即向用户询问**，不要猜测或用空值\n- 有 `default` 的可选输入：使用默认值\n- 无默认值的可选输入：设为空字符串\n\n### 第 3 步：构建执行顺序\n\n根据 `depends_on` 进行拓扑排序，将步骤分成多个层级：\n\n- **无 depends_on 的步骤** → 第 1 层\n- **depends_on 全部在第 N 层或之前的步骤** → 第 N+1 层\n- **同一层内的步骤**互不依赖，可并行\n\n在回复中展示执行计划：\n```\n执行计划（共 N 步）：\n  第 1 层: [step_id] — 角色名\n  第 2 层: [step_a, step_b] — 并行\n  第 3 层: [step_id] — 角色名\n```\n\n### 第 4 步：逐层执行\n\n对每一层：\n\n#### 4a. 预读角色文件\n\n用 Read 工具读取该层所有步骤的角色 `.md` 文件：`{角色目录}\u002F{role}.md`\n\n从文件中提取：\n- **角色名**：frontmatter 中的 `name` 字段\n- **角色 system prompt**：第二个 `---` 之后的全部 markdown 内容\n\n#### 4b. 渲染 task 模板\n\n将 task 中的 `{{变量名}}` 替换为：\n- 来自 inputs 的用户输入值\n- 来自前序步骤 output 的结果文本\n\n#### 4c. 执行\n\n**单步骤层**：直接在主会话中扮演该角色执行。格式：\n\n```\n### Step N\u002FTotal: step_id（角色名）\n\n[以该角色身份完成 task，使用角色的专业知识和沟通风格]\n```\n\n**多步骤层（并行）**：使用 Agent 工具为每个步骤启动子代理。每个子代理的 prompt 必须包含：\n- 角色文件的**完整文本内容**（不是路径——子代理可能无法读文件）\n- 渲染后的 task 文本\n- 指令：\"以上是你的角色定义，请以该角色身份完成以下任务，直接输出结果\"\n\n#### 4d. 保存输出到上下文\n\n如果 step 有 `output` 字段，将该步骤的输出文本存入变量上下文，供后续步骤的 `{{变量}}` 使用。\n\n### 第 5 步：保存结果并展示\n\n用 Write 工具将结果保存到文件：\n\n```\n.ao-output\u002F{工作流名称}-{YYYY-MM-DD}\u002F\n├── steps\u002F\n│   ├── 1-{step_id}.md       # 每步的输出\n│   ├── 2-{step_id}.md\n│   └── ...\n├── summary.md                # 最后一步的完整输出（最终成果）\n└── metadata.json             # 基本元数据\n```\n\nmetadata.json 格式：\n```json\n{\n  \"name\": \"工作流名称\",\n  \"date\": \"2026-03-22\",\n  \"success\": true,\n  \"steps\": [\n    {\"id\": \"step_id\", \"role\": \"category\u002Fagent\", \"status\": \"completed\"},\n    ...\n  ]\n}\n```\n\n执行完毕后，向用户展示：\n1. 最终成果（summary.md 的内容）\n2. 文件保存位置\n3. 执行了几个步骤\n\n## 重要规则\n\n\u003CHARD-GATE>\n- 每个步骤都必须真正扮演对应角色，使用该角色的专业知识和沟通风格，不能泛泛回答\n- 角色切换必须明确——每步开始时标注角色名\n- 不要跳过步骤或合并步骤，严格按 DAG 层级顺序执行\n- 如果角色文件找不到，告知用户并建议安装 agency-agents-zh\n- 不要在没有读取角色 .md 文件的情况下执行步骤——必须先 Read 再执行\n\u003C\u002FHARD-GATE>\n\n## 没有 YAML 文件时的快捷模式\n\n如果用户没有指定 YAML 文件，但描述了需要多角色协作的任务：\n\n1. 根据用户描述，**自动生成** YAML 工作流定义\n2. 展示给用户确认\n3. 确认后按上述流程执行\n\n示例：\n- 用户说\"帮我用叙事学家和心理学家写个故事\" → 生成 story-creation 类似的工作流\n- 用户说\"让产品经理和架构师评审这个 PRD\" → 生成 product-review 类似的工作流\n\n## 故障处理\n\n- **角色文件不存在**：提示用户运行 `ao init` 或 `npm install agency-agents-zh`\n- **模板变量未定义**：检查上下文，如果是必填输入则向用户询问\n- **步骤执行失败**：标记该步骤为失败，跳过所有依赖它的下游步骤，继续执行其他独立步骤\n","# 工作流执行器：在 AI 工具内运行多角色编排\n\n直接在当前会话中执行 agency-orchestrator 的 YAML 工作流，无需配置 API key。当前 LLM 就是执行引擎——依次扮演每个角色完成任务。\n\n## 适用场景\n\n- 用户提供了一个 `.yaml` 工作流文件（如 `运行 workflows\u002Fstory-creation.yaml`）\n- 用户要求多个角色协作完成任务（如\"用产品经理和架构师一起评审这个 PRD\"）\n- 用户安装了 `agency-agents-zh` 并希望直接在 AI 工具内编排多角色\n\n## 执行流程（5 步）\n\n按以下顺序执行，不要跳步：\n\n### 第 1 步：解析工作流\n\n用 Read 工具读取用户指定的 YAML 文件，提取以下字段：\n\n```yaml\nname: \"工作流名称\"\nagents_dir: \"agency-agents-zh\"    # 角色定义目录\ninputs:                            # 输入变量\n  - name: xxx\n    required: true\u002Ffalse\n    default: \"默认值\"\nsteps:                             # 执行步骤\n  - id: step_id\n    role: \"category\u002Fagent-name\"    # 角色路径\n    task: \"任务描述 {{变量}}\"       # 支持模板变量\n    output: variable_name          # 输出变量名\n    depends_on: [other_step_id]    # 依赖关系\n```\n\n**忽略 `llm`、`concurrency`、`timeout`、`retry` 配置**——Skill 模式使用当前会话的 LLM，这些字段仅用于 CLI 模式。\n\n**定位角色目录**：用 Bash `test -d` 按以下顺序检查，用第一个存在的：\n1. 当前工作目录下的 `{agents_dir}\u002F`（如 `.\u002Fagency-agents-zh\u002F`）\n2. `..\u002F{agents_dir}\u002F`（上级目录）\n3. 相对于 YAML 文件所在目录的 `{agents_dir}\u002F`\n4. `node_modules\u002Fagency-agents-zh\u002F`\n\n如果全部找不到，**停止执行**并提示用户：\n```\n找不到角色目录。请先安装：\n  git clone --depth 1 https:\u002F\u002Fgithub.com\u002FjnMetaCode\u002Fagency-agents-zh.git\n  或：npm install agency-agents-zh\n```\n\n### 第 2 步：收集输入\n\n- 对每个 `required: true` 的输入，检查用户消息中是否已提供值\n- 未提供的必填输入：**立即向用户询问**，不要猜测或用空值\n- 有 `default` 的可选输入：使用默认值\n- 无默认值的可选输入：设为空字符串\n\n### 第 3 步：构建执行顺序\n\n根据 `depends_on` 进行拓扑排序，将步骤分成多个层级：\n\n- **无 depends_on 的步骤** → 第 1 层\n- **depends_on 全部在第 N 层或之前的步骤** → 第 N+1 层\n- **同一层内的步骤**互不依赖，可并行\n\n在回复中展示执行计划：\n```\n执行计划（共 N 步）：\n  第 1 层: [step_id] — 角色名\n  第 2 层: [step_a, step_b] — 并行\n  第 3 层: [step_id] — 角色名\n```\n\n### 第 4 步：逐层执行\n\n对每一层：\n\n#### 4a. 预读角色文件\n\n用 Read 工具读取该层所有步骤的角色 `.md` 文件：`{角色目录}\u002F{role}.md`\n\n从文件中提取：\n- **角色名**：frontmatter 中的 `name` 字段\n- **角色 system prompt**：第二个 `---` 之后的全部 markdown 内容\n\n#### 4b. 渲染 task 模板\n\n将 task 中的 `{{变量名}}` 替换为：\n- 来自 inputs 的用户输入值\n- 来自前序步骤 output 的结果文本\n\n#### 4c. 执行\n\n**单步骤层**：直接在主会话中扮演该角色执行。格式：\n\n```\n### Step N\u002FTotal: step_id（角色名）\n\n[以该角色身份完成 task，使用角色的专业知识和沟通风格]\n```\n\n**多步骤层（并行）**：使用 Agent 工具为每个步骤启动子代理。每个子代理的 prompt 必须包含：\n- 角色文件的**完整文本内容**（不是路径——子代理可能无法读文件）\n- 渲染后的 task 文本\n- 指令：\"以上是你的角色定义，请以该角色身份完成以下任务，直接输出结果\"\n\n#### 4d. 保存输出到上下文\n\n如果 step 有 `output` 字段，将该步骤的输出文本存入变量上下文，供后续步骤的 `{{变量}}` 使用。\n\n### 第 5 步：保存结果并展示\n\n用 Write 工具将结果保存到文件：\n\n```\n.ao-output\u002F{工作流名称}-{YYYY-MM-DD}\u002F\n├── steps\u002F\n│   ├── 1-{step_id}.md       # 每步的输出\n│   ├── 2-{step_id}.md\n│   └── ...\n├── summary.md                # 最后一步的完整输出（最终成果）\n└── metadata.json             # 基本元数据\n```\n\nmetadata.json 格式：\n```json\n{\n  \"name\": \"工作流名称\",\n  \"date\": \"2026-03-22\",\n  \"success\": true,\n  \"steps\": [\n    {\"id\": \"step_id\", \"role\": \"category\u002Fagent\", \"status\": \"completed\"},\n    ...\n  ]\n}\n```\n\n执行完毕后，向用户展示：\n1. 最终成果（summary.md 的内容）\n2. 文件保存位置\n3. 执行了几个步骤\n\n## 重要规则\n\n\u003CHARD-GATE>\n- 每个步骤都必须真正扮演对应角色，使用该角色的专业知识和沟通风格，不能泛泛回答\n- 角色切换必须明确——每步开始时标注角色名\n- 不要跳过步骤或合并步骤，严格按 DAG 层级顺序执行\n- 如果角色文件找不到，告知用户并建议安装 agency-agents-zh\n- 不要在没有读取角色 .md 文件的情况下执行步骤——必须先 Read 再执行\n\u003C\u002FHARD-GATE>\n\n## 没有 YAML 文件时的快捷模式\n\n如果用户没有指定 YAML 文件，但描述了需要多角色协作的任务：\n\n1. 根据用户描述，**自动生成** YAML 工作流定义\n2. 展示给用户确认\n3. 确认后按上述流程执行\n\n示例：\n- 用户说\"帮我用叙事学家和心理学家写个故事\" → 生成 story-creation 类似的工作流\n- 用户说\"让产品经理和架构师评审这个 PRD\" → 生成 product-review 类似的工作流\n\n## 故障处理\n\n- **角色文件不存在**：提示用户运行 `ao init` 或 `npm install agency-agents-zh`\n- **模板变量未定义**：检查上下文，如果是必填输入则向用户询问\n- **步骤执行失败**：标记该步骤为失败，跳过所有依赖它的下游步骤，继续执行其他独立步骤\n",{"name":5,"license":15,"version":42,"metadata":43,"description":7},"1.0.0",{"hermes":44},{"tags":45},[30,24],"main","11fa3057bb1aff51d77b97648803dec2b2ea62d9",".agents\u002Fskills\u002Fworkflow-runner",2,"https:\u002F\u002Fgithub.com\u002Frzx007\u002FVykor","https:\u002F\u002Frzx007.github.io\u002FVykor\u002F","https:\u002F\u002Fgithub.com\u002Frzx007","2026-11-13 23:57:39",{"source":8,"skillName":5,"commands":55,"prompt":65,"zipAvailable":66},[56,59,62],{"tool":57,"command":58},"npx","npx skills add rzx007\u002FVykor --skill workflow-runner",{"tool":60,"command":61},"bunx","bunx skills add rzx007\u002FVykor --skill workflow-runner",{"tool":63,"command":64},"pnpm","pnpm dlx skills add rzx007\u002FVykor --skill workflow-runner","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Frzx007\u002FVykor\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fworkflow-runner\u002FSKILL.md",true,[],[69,87,99,105,117,130],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":83,"publishedAt":37},"01M6RVYYTPGG9WWWV4QAY0YEY3","writing-skills","当创建新技能、编辑现有技能或在部署前验证技能是否有效时使用","https:\u002F\u002Fgithub.com\u002Frzx007\u002FVykor\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwriting-skills\u002FSKILL.md",[75,78],{"categoryNo":76,"categoryName":77,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000018","写作与文案",{"categoryNo":79,"categoryName":80,"taxonomyType":81,"taxonomyTypeDesc":82},"01JBSEEDCAT000000000000036","内容创作者","PROFESSION","适用职业",[84,85,86],"writing skills","writing","documentation",{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":95,"publishedAt":37},"01M6RVYE486HE8NQ2M4G5DNG63","writing-plans","当你有规格说明或需求用于多步骤任务时使用，在动手写代码之前","https:\u002F\u002Fgithub.com\u002Frzx007\u002FVykor\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwriting-plans\u002FSKILL.md",[93,94],{"categoryNo":76,"categoryName":77,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":79,"categoryName":80,"taxonomyType":81,"taxonomyTypeDesc":82},[96,97,85,98,86],"plans","writing plans","planning",{"skillNo":100,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":104,"publishedAt":37},"01M6RVY778PEDPWQ0DCM25QW3A","https:\u002F\u002Fgithub.com\u002Frzx007\u002FVykor\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fworkflow-runner\u002FSKILL.md",[103],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[26,25,24,32,36,35,34,33,31,30,29,28,27],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":37},"01M6RVY4NR6RRPV174AB706A13","verification-before-completion","在宣称工作完成、已修复或测试通过之前使用，在提交或创建 PR 之前——必须运行验证命令并确认输出后才能声称成功；始终用证据支撑断言","https:\u002F\u002Fgithub.com\u002Frzx007\u002FVykor\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fverification-before-completion\u002FSKILL.md",[],[112,113,114,115,116],"verification before completion","verification","quality","pr","testing",{"skillNo":118,"name":119,"nameZh":6,"description":120,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":121,"categories":122,"keywords":123,"publishedAt":37},"01M6RVY1ZQ6ADVCZGBS371HD88","using-superpowers","在开始任何对话时使用——确立如何查找和使用技能，要求在任何响应（包括澄清性问题）之前调用 Skill 工具","https:\u002F\u002Fgithub.com\u002Frzx007\u002FVykor\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fusing-superpowers\u002FSKILL.md",[],[124,125,126,127,128,129],"superpowers","using superpowers","对话","Meta","工具","getting-started",{"skillNo":131,"name":132,"nameZh":6,"description":133,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":134,"categories":135,"keywords":136,"publishedAt":37},"01M6RVXJFEQ00P7XBQ8FBEKKJ2","using-git-worktrees","当需要开始与当前工作区隔离的功能开发，或在执行实现计划之前使用——通过原生工具或 git worktree 回退机制确保隔离工作区存在","https:\u002F\u002Fgithub.com\u002Frzx007\u002FVykor\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fusing-git-worktrees\u002FSKILL.md",[],[137,138,139,140,141,24,142,143,128],"using git worktrees","git","git worktrees","worktrees","Using git","worktree","git worktree"]