yuanflow-cli 0.1.15 → 0.1.16

package/README.md

@@ -127,6 +127,8 @@ yuanflow-cli knowledge rule-detail --rule-code some_rule_code --output-format sh
 
 Agent 应先查看 `knowledge docs`，再把用户需求整理成 `task_frame`，按接口返回的 `next_actions` 渐进查询。v2 接口不要求 `task_intent`；旧字段仅保留兼容。`packs`、`rules` 的 `data` 可能直接是数组，Agent 不应假设固定对象结构，应优先读取 `next_actions` 继续下钻。
 
+`knowledge entry`、`knowledge packs`、`knowledge evaluate` 会按规则库实际校验要求本地检查 `task_frame.domain` 和 `task_frame.content_goal`，CLI 调用时必须传 `--domain` 和 `--content-goal`，或通过 `--task-frame-file` 提供同名字段。`rules` 和 `rule-detail` 用于按已选包/规则继续下钻，仍必须分别传 `--pack-code` 或 `--rule-code`。
+
 ### OSS 原子能力
 
 OSS 能力独立封装为 `oss` 命令，用于临时上传、签名链接和对象复制：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuanflow-cli",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "YuanFlow API CLI and skill installer for supported AI coding agents.",
   "type": "module",
   "license": "MIT",

package/skills/yuanflow-skill//350/207/252/345/252/222/344/275/223/347/237/245/350/257/206/345/272/223/SKILL.md

@@ -46,7 +46,7 @@ description: 当用户需要做自媒体选题、开头钩子、脚本、文案
 yuanflow-cli knowledge docs --format agent-json
 ```
 
-2. 把用户需求整理为 `task_frame`，再进入知识库：
+2. 把用户需求整理为 `task_frame`，再进入知识库。`task_frame.domain` 和 `task_frame.content_goal` 是规则库实际要求的必填字段，CLI 调用时必须传 `--domain` 和 `--content-goal`，不要用空字符串占位：
 
 ```bash
 yuanflow-cli knowledge entry \
@@ -100,6 +100,7 @@ yuanflow-cli knowledge rules \
 - 不要让 Agent 自己拼 SQL。
 - 不要使用 `/atomic/aliyun-db/query` 查询知识库内部表。
 - 不要把知识库核心方法论静态写入回复，只按接口返回内容使用。
+- `knowledge entry`、`knowledge packs`、`knowledge evaluate` 必须提供 `--domain` 和 `--content-goal`；也可以用 `--task-frame-file` 提供同名字段。
 - 如果接口返回 `next_actions`，优先按它推荐的动作继续查询。
 - v2 接口不要求 `task_intent`；旧字段只作为兼容字段，不要在新调用里默认填写。
 - `packs`、`rules` 的 `data` 可能直接是数组，不要假设固定 `{ packs: [] }` 或 `{ rules: [] }` 结构。

package/src/knowledge-tools.js

@@ -46,10 +46,12 @@ export async function getKnowledgeDocs({ options }) {
 }
 
 export async function navigateKnowledge({ action, options }) {
+  const normalizedAction = normalizeAction(action);
   const taskFrame = await buildTaskFrame(options);
   const params = buildParams(action, options);
+  validateTaskFrame(normalizedAction, taskFrame);
   const body = {
-    action: normalizeAction(action),
+    action: normalizedAction,
     task_frame: taskFrame,
     params,
   };
@@ -60,7 +62,7 @@ export async function navigateKnowledge({ action, options }) {
   });
   return {
     ok: true,
-    action: normalizeAction(action),
+    action: normalizedAction,
     endpoint: { method: 'POST', path: KNOWLEDGE_NAVIGATE_PATH, kind: 'knowledge-base' },
     request: { body },
     response,
@@ -95,7 +97,7 @@ function taskFrameOptions() {
     { flag: '--task-intent', name: 'taskIntent', required: false, label: '兼容旧字段；v2 接口不要求填写。' },
     { flag: '--output-format', name: 'outputFormat', required: false, label: '输出格式，例如 short_video_script、social_post、any。' },
     { flag: '--domain', name: 'domain', required: false, label: '内容领域。' },
-    { flag: '--content-goal', name: 'contentGoal', required: false, label: '具体创作或评估目标。' },
+    { flag: '--content-goal', name: 'contentGoal', required: true, label: '具体创作或评估目标；等同 task_frame.content_goal，不能为空。' },
     { flag: '--target-audience', name: 'targetAudience', required: false, label: '目标受众，例如 创业者、宝妈、普通用户。' },
     { flag: '--tone', name: 'tone', required: false, label: '语气风格。' },
     { flag: '--communication-mode', name: 'communicationMode', required: false, label: '表达方式，例如 口播、图文、文章。' },
@@ -144,6 +146,21 @@ function buildParams(action, options) {
   return params;
 }
 
+function validateTaskFrame(action, taskFrame) {
+  if (!taskFrame || typeof taskFrame !== 'object' || Array.isArray(taskFrame)) {
+    throw new Error('task_frame 必须是对象。');
+  }
+  if (!['entry', 'packs', 'evaluate'].includes(action)) {
+    return;
+  }
+  if (!cleanOptional(taskFrame.domain)) {
+    throw new Error('缺少 --domain 或 task_frame.domain。');
+  }
+  if (!cleanOptional(taskFrame.content_goal)) {
+    throw new Error('缺少 --content-goal 或 task_frame.content_goal。');
+  }
+}
+
 function normalizeAction(action) {
   return action === 'rule-detail' ? 'rule_detail' : action;
 }