Goofish Publish Item

What it does

Example prompts

• “帮我发到闲鱼 / 挂个闲置 / 把 XX 上架 / 发布一件 / 新增商品 / 上新”
• “这个怎么写标题 / 类目该选啥 / 图片够了吗”
• “/goofish-publish-item”

Requirements

• Pre-approved tools (allowed-tools): mcp__goofish__auth_status, mcp__goofish__category_recommend, mcp__goofish__media_upload, mcp__goofish__location_default, mcp__goofish__item_publish, mcp__goofish__item_get

Workflow steps

7 steps, taken from the step headings in SKILL.md.

1. 1登录态自检（必做）
2. 2信息收集
3. 3类目识别
4. 4标题生成
5. 5描述生成
6. 6图片处理
7. 7用户最终确认 + 发布

What it can do on your machine

Read from SKILL.md and the folder at commit c2b397f. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • mcp__goofish__auth_status
  • mcp__goofish__category_recommend
  • mcp__goofish__media_upload
  • mcp__goofish__location_default
  • mcp__goofish__item_publish
  • mcp__goofish__item_get

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Goofish Publish Item loads about 928 tokens when it runs, and up to ~4.1k if it reads all its reference files. Until then it costs about 64 tokens; SKILL.md has 230 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~64

When it runs · the whole SKILL.md, loaded when a task matches

~928

With references · SKILL.md plus every file in references/, read only if the agent opens them

~4.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from fancyboi999/goofish-cli at commit c2b397f, republished under its Apache-2.0 licence (© fancyboi999). 230 words, ~928 tokens.

name

goofish-publish-item

description

闲鱼发商品 skill。何时激活：用户说"帮我发到闲鱼 / 挂个闲置 / 把 XX 上架 / 发布一件 / 新增商品 / 上新"；或说"这个怎么写标题 / 类目该选啥 / 图片够了吗"。 功能：从 raw 描述 / 图片 → 确认类目 → 生成标题候选 → 风控预检 → 批量传图 → 拿默认地址 → 调用 `item_publish` 一键发布。核心约束：**发送前必须让用户确认文案**， 不自动提交；调用 `goofish-risk-guard` 做发布前扫描。

allowed-tools

mcp__goofish__auth_status, mcp__goofish__category_recommend, mcp__goofish__media_upload, mcp__goofish__location_default, mcp__goofish__item_publish, mcp__goofish__item_get

metadata.author

goofish-cli

metadata.version

0.3.0

metadata.tags

xianyu, publish, listing

调 auth_status
  valid=true → 继续
  valid=false → 不继续；告诉用户: "登录态失效了，请执行 goofish auth login（扫码走 --qr）"，停。

调 category_recommend(title=候选标题, images_json="[]")
  → 拿到完整类目 DTO；已有上传收据时用 images_json=JSON.stringify(收据数组)

for image in 本地图片路径:
    调 media_upload(path=image)
    收集返回的 {url, width, height}

检查:
    总图数 ≤ 9 ？
    首图是 1:1 ？（如果不是，提示用户换首图）
    张数 ≥ 3 ？（少于 3 张警告但不拦）

【标题】...（最终版）
【类目】catName (catId=XXXX)
【描述】
（全文）
【价格】XXX 元
【图片】9 张，首图 1:1 ✅
【发货地】XX 市 / 默认
【风控扫描】通过 ✅

是否确认发布？

调 item_publish(
    title=..., 
    desc=..., 
    price=..., 
    images_json=JSON.stringify([{url, width, height}, ...]),
    category_json=JSON.stringify(category_recommend 的完整 DTO),
    location_json=JSON.stringify(location_default 的完整 DTO)
)

© fancyboi999, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in skills/goofish-publish-item of fancyboi999/goofish-cli.

• SKILL.md
• references/category-selection.md
• references/common-pitfalls.md
• references/image-checklist.md
• references/title-formula.md

Open the folder on GitHubat commit c2b397f