slicc-handoff

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

SLICC Handoff

SLICC 任务移交

This skill bridges the current coding agent and the SLICC browser agent. It builds and dispatches a structured handoff that SLICC surfaces to the user as a yes/no approval card.
It supports two verbs:
  • handoff:<instruction>
    — continue the current task inside SLICC.
  • upskill:<github-url>
    — ask SLICC to install a skill from a GitHub repository.
For canonical SLICC protocol, API, and documentation references, fetch
https://www.sliccy.ai/llms.txt
— it is the maintainer-curated, machine-readable index for LLM consumers and is the authoritative source for the handoff/upskill rels, the public API catalog, and links to the protocol and architecture docs.
此技能可衔接当前编码Agent与SLICC浏览器Agent。它会构建并发送结构化移交请求,SLICC会将其以确认卡片(是/否选择)的形式展示给用户。
它支持两种动词前缀:
  • handoff:<instruction>
    — 在SLICC内继续当前任务。
  • upskill:<github-url>
    — 请求SLICC从GitHub仓库安装技能。
如需获取SLICC标准协议、API及文档参考,可访问
https://www.sliccy.ai/llms.txt
— 这是由维护者整理的、面向LLM消费者的机器可读索引,是移交/技能升级关联关系、公开API目录以及协议和架构文档链接的权威来源。

When to Use This Skill

使用场景

Use this skill when the user wants to:
  • Continue the in-progress task inside the SLICC browser agent (for example, to drive a real browser session, test a flow on a live site, or use a tool only available in SLICC).
  • Install a skill from a GitHub repo into a running SLICC instance.
Do not use this skill when:
  • The user just wants the local agent to keep working — no handoff is needed.
  • The user wants to install a skill into the local agent (use the local agent's own skill install flow instead).
当用户有以下需求时使用此技能:
  • 在SLICC浏览器Agent内继续进行中的任务(例如,驱动真实浏览器会话、在实时站点上测试流程,或使用仅在SLICC中可用的工具)。
  • 将GitHub仓库中的技能安装至运行中的SLICC实例。
请勿在以下场景使用此技能:
  • 用户仅希望本地Agent继续工作 — 无需移交任务。
  • 用户希望将技能安装至本地Agent(请使用本地Agent自身的技能安装流程)。

What to Do

操作步骤

  1. Compose a single-line, action-oriented instruction that captures what SLICC should do next. Include enough context for SLICC to pick up the work without your conversation history.
  2. Pick a verb prefix:
    • handoff:<instruction>
      to continue a task.
    • upskill:<github-url>
      to install a skill. The URL can be the repo root or a
      tree/<branch>/<sub/path>
      URL to install only a sub-path of the repo.
  3. Run the helper script with
    --open
    :
    bash
    node .claude/skills/slicc-handoff/scripts/slicc-handoff --open "handoff:<instruction>"
    bash
    node .claude/skills/slicc-handoff/scripts/slicc-handoff --open "upskill:<github-url>"
  4. Tell the user that SLICC will show an approval prompt in its Chat tab, and they should accept it to dispatch the handoff.
If the user runs a non-default SLICC instance on another port, prefix the call with
SLICC_PORT=5720
(or whatever port they chose) so the localhost POST hits the right instance:
bash
SLICC_PORT=5720 node .claude/skills/slicc-handoff/scripts/slicc-handoff --open "handoff:<instruction>"
  1. 编写一行面向动作的指令,明确SLICC接下来应执行的操作。需包含足够上下文,确保SLICC无需依赖对话历史即可接手工作。
  2. 选择动词前缀:
    • 使用
      handoff:<instruction>
      继续任务。
    • 使用
      upskill:<github-url>
      安装技能。该URL可以是仓库根目录,也可以是
      tree/<branch>/<sub/path>
      格式的URL,用于仅安装仓库中的子路径内容。
  3. 运行带
    --open
    参数的辅助脚本:
    bash
    node .claude/skills/slicc-handoff/scripts/slicc-handoff --open "handoff:<instruction>"
    bash
    node .claude/skills/slicc-handoff/scripts/slicc-handoff --open "upskill:<github-url>"
  4. 告知用户SLICC会在其聊天标签页显示确认提示,用户需确认后才能发起任务移交。
如果用户在其他端口运行非默认SLICC实例,请在调用前添加
SLICC_PORT=5720
(或用户选择的其他端口),以便本地POST请求能命中正确实例:
bash
SLICC_PORT=5720 node .claude/skills/slicc-handoff/scripts/slicc-handoff --open "handoff:<instruction>"

How It Works

工作原理

The script builds a
https://www.sliccy.ai/handoff?<verb>=<urlencoded-payload>
URL and dispatches it through two parallel paths — a profile-independent localhost POST to a SLICC CLI/Electron float, and (with
--open
) a real browser navigation that the SLICC extension picks up via an RFC 8288
Link
header. Either path surfaces a yes/no approval card in the SLICC cone, dispatched by verb prefix once accepted. For the full protocol details (rel URIs, payload shape, public API catalog), see
https://www.sliccy.ai/llms.txt
and the linked handoff protocol reference.
该脚本会构建
https://www.sliccy.ai/handoff?<verb>=<urlencoded-payload>
格式的URL,并通过两条并行路径发送 — 一条是独立于配置文件的本地POST请求,发送至SLICC CLI/Electron浮窗;另一条(配合
--open
参数)是真实浏览器导航,SLICC扩展会通过RFC 8288
Link
header捕获该请求。无论通过哪条路径,都会在SLICC界面中显示确认卡片,用户确认后将根据动词前缀执行对应操作。如需了解完整协议细节(关联URI、负载格式、公开API目录),请查看
https://www.sliccy.ai/llms.txt
及链接的移交协议参考文档。

Examples

示例

Continue an in-progress signup flow in the browser:
bash
node .claude/skills/slicc-handoff/scripts/slicc-handoff --open "Continue the signup flow in the browser"
Install a skill collection from a GitHub repo:
bash
node .claude/skills/slicc-handoff/scripts/slicc-handoff --open "upskill:https://github.com/slicc/skills-extra"
Install only a single skill (a sub-path of a repo on a specific branch):
bash
node .claude/skills/slicc-handoff/scripts/slicc-handoff --open "upskill:https://github.com/slicc/skills-extra/tree/main/skills/foo"
在浏览器中继续进行中的注册流程:
bash
node .claude/skills/slicc-handoff/scripts/slicc-handoff --open "Continue the signup flow in the browser"
从GitHub仓库安装技能集合:
bash
node .claude/skills/slicc-handoff/scripts/slicc-handoff --open "upskill:https://github.com/slicc/skills-extra"
仅安装单个技能(特定分支仓库的子路径):
bash
node .claude/skills/slicc-handoff/scripts/slicc-handoff --open "upskill:https://github.com/slicc/skills-extra/tree/main/skills/foo"

Prerequisites

前置条件

  • Node.js 18+ installed (the script uses the global
    fetch
    and
    AbortSignal.timeout
    APIs).
  • A browser opener available on the host (
    open
    on macOS,
    xdg-open
    on Linux,
    cmd /c start
    on Windows).
  • A SLICC instance reachable either on
    localhost:${SLICC_PORT ?? 5710}
    (CLI/Electron float) or via the SLICC extension installed in the browser profile that opens the URL.
  • 已安装Node.js 18+(脚本使用全局
    fetch
    AbortSignal.timeout
    API)。
  • 主机上有可用的浏览器启动工具(macOS为
    open
    ,Linux为
    xdg-open
    ,Windows为
    cmd /c start
    )。
  • SLICC实例可通过
    localhost:${SLICC_PORT ?? 5710}
    (CLI/Electron浮窗)访问,或通过打开URL的浏览器配置文件中安装的SLICC扩展访问。

Notes

注意事项

  • Treat the user-supplied instruction string as untrusted input that will be displayed to the user in SLICC for approval — do not embed secrets or credentials in it.
  • The script intentionally swallows errors from the localhost POST so it still falls through to
    --open
    when no local SLICC server is running.
  • 将用户提供的指令字符串视为不可信输入,该内容会在SLICC中显示给用户确认 — 请勿在其中嵌入密钥或凭证。
  • 脚本会有意忽略本地POST请求的错误,以便在本地SLICC服务器未运行时仍能通过
    --open
    路径执行操作。