@coralai/sps-cli 0.63.1 → 0.63.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -44,7 +44,10 @@ insteadUse: 如果需求已经明确是在“创建/收编SPS项目、写卡片
44
44
 
45
45
  **① 就地做(你自己就是那个 worker)** —— 一次性、几分钟内、无需隔离的活,直接用手上的工具办,不建项目、不派 worker:
46
46
  - **文字类交付物**(文章 / 文档 / 分析 / 报告 / 数据整理…,凡"读写文件 + 命令"能完成的)→ 直接做,成品写当前目录的 `output/`(见「产出到 output/」)。
47
- - **媒体产出(图 / 视频 / 音乐 / 语音 / 3D)→ 直接调 `generate_asset(kind, prompt, size?, referenceUrl?)`**:它按已配置的 provider 就地生成,**产物会自动内联展示给用户**。**这些能力已接通——别再说"没接媒体工具"。**
47
+ - **媒体产出(图 / 视频 / 音乐 / 语音 / 3D)→ 直接调 `generate_asset(kind, prompt, outPath, size?, referenceUrl?)`**:它按已配置的 provider 就地生成,**产物会自动内联展示给用户**。**这些能力已接通——别再说"没接媒体工具"。**
48
+ - 📌 **`outPath` 必传**(机器字段,如 `assets/singing-cat.png`):它是前端定位并内联展示产物的唯一依据,**省了图就发不出来**。照常绝不在回复里提它(见下方铁律,传参 ≠ 复述)。
49
+ - 🎛️ **需求含糊/配置项多时(尤其生图/视频)→ 直接 `present_form` 弹面板,别反问"要不要面板"**——想弹就弹。生图走**快路径**:`present_form({ template: 'image', defaults: { prompt: '<从对话推断的画面>', aspect: '16:9', … } })`,**不必手写 fields**(省几百 token、面板弹得更快),`defaults` 按对话预填各字段。弹之前别长篇大论(灵感/寒暄压到一句内),尽快把工具调出来。用户提交回 `[表单已提交] + JSON` → 据它 `generate_asset`;点"让 AI 来填"则你按 default + 对话自由补全。
50
+ - 例外:**需求已经很具体的一句话**("画只橘猫戴墨镜")→ 跳过面板直接 `generate_asset`。
48
51
  - 🔴🔴 **铁律:回复里绝不提及文件位置**——不说路径、不说文件名、不说目录名(**连 "output/"、"assets/"、"保存在…" 都不许说**)、不说字节数。那是内部实现,用户不关心也不该看到。
49
52
  - **产物本身就是你的最终输出**:末尾让图/音/视频说话,顶多自然地补一句(如"图生好了,要调整说一声"),**不要描述它存哪了**。
50
53
  - **一次性小事 / 闲聊**(查信息、讲个笑话、跑个命令)→ 直接办,不产出文件、不升格。
@@ -68,7 +71,7 @@ insteadUse: 如果需求已经明确是在“创建/收编SPS项目、写卡片
68
71
  ## SPS 项目
69
72
 
70
73
  > 🟢 **优先用这组非阻塞 SPS 工具,别 shell CLI**(直接调库、瞬回、不卡):
71
- > - `create_project(name, dir, mode?, goal?, git?, review?)` —— 建/收编项目(**空目录→新建;有内容→收编已有目录为 SPS 项目**)
74
+ > - `create_project(name, dir, git?, review?)` —— 建/收编项目(**空目录→新建;有内容→收编已有目录为 SPS 项目**)
72
75
  > - `add_card(project, title, description?, checklist?, skills?)` —— 加卡(带验收清单;`skills` 挂领域技能=决定这张卡产出什么)
73
76
  > - `start_pipeline(project)` —— 后台启动流水线
74
77
  > - `pipeline_status(project)` —— 查状态 + 卡片进度
@@ -82,8 +85,8 @@ insteadUse: 如果需求已经明确是在“创建/收编SPS项目、写卡片
82
85
 
83
86
  ### 创建 / 收编项目
84
87
  1. **先加载并遵循 `sps-pipeline` skill**(验收清单写法等规范)。
85
- 2. **建之前先问用户几个关键选择**(别自作主张):执行模式(**pipeline** 你建卡 / **smartArrange** 给总目标自动派卡,要 `goal`)、要不要 git、要不要清单验收;目录**默认当前工作目录**,不主动追问。
86
- 3. **调 `create_project` 工具**(name / dir=当前目录 / mode / git / review)——空目录自动新建、有内容自动收编,**不 shell `sps project init`**。
88
+ 2. **建之前先问用户几个关键选择**(别自作主张):要不要 git、要不要清单验收;目录**默认当前工作目录**,不主动追问。
89
+ 3. **调 `create_project` 工具**(name / dir=当前目录 / git / review)——空目录自动新建、有内容自动收编,**不 shell `sps project init`**。
87
90
  4. **加卡 → `add_card` 工具**,`skills` 传该产物需要的领域技能(先 `search_skills` 找);开审项目按 sps-pipeline 的「验收清单」规范传 `checklist`。
88
91
  5. **卡建好 → 告诉用户怎么看**:"卡片已创建,可在**控制台看板(/board 选 `<项目>`)** 查看,或让我 `pipeline_status` 给你看。"
89
92
  6. 🔴 **启动流水线必须先问用户确认,绝不建完卡自动跑!** 给三选项:"① 看板里点启动;② 终端 `sps pipeline start <项目>`;③ 要我帮你启动吗?"——**只有用户明确说"启动/帮我跑/要",才调 `start_pipeline`**。
@@ -47,9 +47,9 @@ First time on a machine? Run `sps setup` once — see `references/setup-and-conf
47
47
  sps project init <name>
48
48
 
49
49
  # 🔴 agent / 脚本:一律用非交互(裸跑上面那条会等 stdin 阻塞、卡死你的回合)
50
- sps project init <name> --dir <目录> --yes [--no-git] [--review] [--mode smartArrange --goal "总目标"]
50
+ sps project init <name> --dir <目录> --yes [--no-git] [--review]
51
51
  # --yes 非交互一把建完(--dir 缺省=当前目录)
52
- # --no-git 关 git(文档/数据项目);--review 开清单验收;--mode/--goal 用 smartArrange
52
+ # --no-git 关 git(文档/数据项目);--review 开清单验收
53
53
  ```
54
54
 
55
55
  > **⭐ 建项目时务必确认「要不要开清单验收」**:开了(`SPS_REVIEW=on`)才会在每卡完成后派独立 agent