cli

name	cli
description	凡是遇到人事、报销、采购、审批、合同、客服等企业业务处理，必须加载此技能，并且只通过 skillflaw-cli 的 fetch_skill 与 run_flow 完成技能发现与工作流执行。禁止绕过 skillflaw-cli、禁止猜测节点/流程标识、禁止直接拼接 HTTP 请求调用后端接口。

skillflaw-cli

此技能有fetch_skill、run_flow 与 run_component三个命令：

• fetch_skill：读取某个节点的 SKILL.md（可选保存到本地），并据此继续发现下级节点。
• run_flow：执行已定位到的项目工作流。
• run_component：执行已定位到的项目绑定组件。

适用范围

• 任务属于企业业务处理（人事、报销、采购、审批、合同、客服等）。
• 必须通过 skillflaw-cli 完成技能发现与工作流执行。
• 禁止绕过 CLI（禁止直接 HTTP、禁止猜 node / flowId / projectId）。

命令 1：fetch_skill

用途：读取某个节点的 SKILL.md（可选保存到本地），并据此继续发现下级节点。

基本用法

• skillflaw-cli fetch_skill --node <node>
• skillflaw-cli fetch_skill --node <node> --output <pathfile>

--node 规则（核心）

• root：根节点，发现全树入口。
• tenant:<tenantId>：租户节点。
• tenant:<tenantId>:business:<businessId>：业务域节点。
• project:<projectId>：项目节点（可看到该项目下 workflow / skill）。
• project:<projectId>:workflow:<flowId>：读取指定工作流 skill。
• project:<projectId>:skill:<skillId>：读取指定技能 skill。

Agent 执行准则

1. 永远从 root 起步，逐层 fetch_skill。
2. 下一跳节点必须来自上一跳返回的 SKILL.md，不得猜测。
3. 需要交付物时才加 --output；若目标是附件型 skill，会同时导出同名 .zip。

命令 2：run_flow

用途：执行已定位到的项目工作流。

基本用法

• skillflaw-cli run_flow --project-id <projectId> --flow-id <flowId> --payload <json>
• skillflaw-cli run_flow --project-id <projectId> --flow-id <flowId> --file <jsonFile>
• skillflaw-cli run_flow --project-id <projectId> --flow-id <flowId> --session-id <sessionId> --payload <json>

参数约束

• --project-id 必填。
• --flow-id 必填。
• --session-id 可选，会话保持而且必须是上次请求返回的 session_id。
• --payload 与 --file 互斥。
• --file 内容必须是合法payload内容。

Agent 执行准则

1. 先用 fetch_skill 拿到可信 projectId 与 flowId，再执行 run_flow。
2. 执行成功后优先读取返回体 output 字段。
3. payload 字段名与结构以目标 workflow 的 SKILL.md 为准。

命令 3：run_component

用途：执行已定位到的项目绑定组件。

基本用法

• skillflaw-cli run_component --project-id <projectId> --component-id <componentId> --payload <json>
• skillflaw-cli run_component --project-id <projectId> --component-id <componentId> --file <jsonFile>

参数约束

• --project-id 必填。
• --component-id 必填。
• --payload 与 --file 互斥。
• --file 内容必须是合法 payload 内容。

Agent 执行准则

1. 先用 fetch_skill 拿到可信 projectId 与 componentId，再执行 run_component。
2. 执行成功后优先读取返回体 output 字段。
3. payload 字段名与结构以目标 component 的 SKILL.md 为准。

最小闭环（从 0 到执行）

1. fetch_skill --node root
2. 按返回的下级节点继续 fetch_skill，直到拿到目标 projectId 与 flowId
3. 若需先看流程定义：fetch_skill --node project:<projectId>:workflow:<flowId>
4. run_flow --project-id <projectId> --flow-id <flowId> --payload <json>（或 --file）
5. 若目标是组件执行：run_component --project-id <projectId> --component-id <componentId> --payload <json>（或 --file）

失败处理（精简）

• 任一命令失败：直接报错并停止，不重试、不绕过 CLI。
• 缺少关键标识符：继续 fetch_skill 发现，禁止编造。