数据测试
- 作者仓库星标 1,322
- 作者更新于 实时读取
- 作者仓库 1688-shopkeeper
- 领域
- 通用
- 兼容 Agent
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- 信任分
- 88 / 100 · 社区维护
- 作者 / 版本 / 许可
- @next-1688 · 未声明 license
- Token 消耗评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部 API Key
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 底层运行要求
- 无特殊要求
- 文件与系统权限
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 26 条
档案由构建时根据 SKILL.md 与安装命令自动衍生,可能与作者实际意图存在差异。
需要注意: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: 1688-shopkeeper
description: | 统一入口:python3 {baseDir}/cli.py <command> [options] 完全本地运行;兼容 Claude Code, Cursor, Cline 等 26 个…
category: 通用
runtime: 无特殊运行时
---
# 1688-shopkeeper 输出预览
## PART A: 任务判断
- 适用问题:通用任务拆解、检查和交付。
- 输入要求:目标材料、限制条件、期望输出和验收方式。
- 证据边界:围绕“命令速查 / 使用流程 / 安全声明”读取原文规则,不把推断写成作者承诺。
## PART B: 执行结果
- **01** 任务判断:确认你的需求是否属于通用任务拆解、检查和交付,并标出输入、限制和预期结果。
- **02** 执行计划:优先按“命令速查 / 使用流程 / 安全声明”拆成步骤,说明每一步会读取什么、修改什么、产出什么。
- **03** 交付结果:给出可复制的命令、文件改动、检查清单或内容草稿,并说明如何继续迭代。
- **04** 风险边界:结合 读取文件、写入/修改文件、主要在本地完成、通常不需要额外 API Key 给出执行前确认项。
## Running Rules
- 读取文件、写入/修改文件;主要在本地完成;通常不需要额外 API Key。
- 先小样例验证,再放大到真实任务。
- 交付时同时给结果、检查口径和下一步迭代建议。 原文没有稳定的斜杠命令要求。安装验证后通常全局生效,直接在对话里点名这个 Skill 并描述任务即可。
告诉 Agent 目标文件或材料、期望结果、不可改范围、是否允许联网或执行命令。本 Skill 的权限画像是:读取文件、写入/修改文件。
先用一个小任务确认它会围绕“命令速查 / 使用流程 / 安全声明”工作;涉及文件或命令时,先看 diff、日志、预览或测试结果。
检查最终产物是否包含明确结果、必要证据和下一步动作;如果输出泛泛而谈,就补充输入、边界和验收标准后重跑。
---
name: 1688-shopkeeper
description: | 统一入口:python3 {baseDir}/cli.py <command> [options] 完全本地运行;兼容 Claude Code, Cursor, Cline 等 26 个…
category: 通用
source: next-1688/1688-shopkeeper
---
# 1688-shopkeeper
## 什么时候使用
- 1688-shopkeeper 是一个通用扩展技能,按 SKILL 适合处理通用任务拆解、检查、交付和复盘,核心价值是把输入、判断、执行、验证和交付边界固定下来,避免 Agent 泛泛回答。 把任务拆成可执行、可检查、可继续迭代的步骤…
- 面向通用任务拆解、检查和交付,优先处理能明确输入、步骤和验收标准的工作。
## 需要提供什么
- 目标材料、目录范围、期望结果和不可改动内容。
- 是否允许联网、执行命令、读写文件或调用外部服务。
## 执行规则
- 围绕「命令速查 / 使用流程 / 安全声明」组织步骤,不把推断写成作者事实。
- 读取文件、写入/修改文件;主要在本地完成;通常不需要额外 API Key。
- 先跑小样例,确认结果可检查后再扩大任务范围。
## 输出要求
- 给出最终产物、关键证据、验证方式和下一步动作。
- 信息不足时标记 unknown,不编造命令、平台或依赖。 作者原文负责流程事实;仓库文件负责来源和命令;流狐只补充适用场景、限制和质量判断。
skill "1688-shopkeeper" {
输入层 -> 用户目标 + 目标文件 + 禁止范围 + 验收标准
上下文层 -> 命令速查 / 使用流程 / 安全声明
规则层 -> SKILL.md 触发条件 / 执行顺序 / 输出格式
运行层 -> 无特殊运行时 | 读取文件、写入/修改文件 | 主要在本地完成
安全层 -> 通常不需要额外 API Key + 小任务验证 + diff / 日志复核
输出层 -> 可复制结果 + 检查清单 + 下一步迭代
} 1688-shopkeeper
统一入口:python3 {baseDir}/cli.py <command> [options]
命令速查
| 命令 | 说明 | 示例 |
|---|---|---|
search |
找商品 | cli.py search --query "帮我找1688上支持一件代发包邮的露营椅,100元以内" --channel douyin |
prod_detail |
商品详情 | cli.py prod_detail --item-ids "991122553819,894138137003" |
shops |
查绑定店铺 | cli.py shops |
publish |
铺货 | cli.py publish --shop-code CODE --data-id ID |
opportunities |
商机热榜 | cli.py opportunities |
trend |
趋势洞察 | cli.py trend --query "大码女装" |
shop_daily |
店铺经营日报 | cli.py shop_daily |
configure |
配置 AK | cli.py configure YOUR_AK |
check |
检查配置状态 | cli.py check |
所有命令输出 JSON:{"success": bool, "markdown": str, "data": {...}}
展示时直接输出 markdown 字段,Agent 分析追加在后面,不得混入其中。
使用流程
Agent 根据用户意图直接执行对应命令,无需每次先执行 check。
各命令在 AK 缺失、店铺异常等情况下会自行返回明确错误,Agent 按下方「异常处理」应对即可。
选品铺货典型路径:search → 用户筛选 → shops(确认目标店铺) → publish
商品详情使用指引:
prod_detail:用户想看商品标题、价格、类目、SKU、CPV 属性、商家信息时使用。
商机/趋势使用指引:
opportunities:用户想看“此刻/近1小时/热榜/趋势商机”。trend:用户询问某宽泛类目/行业的周期趋势、价格分布、热品概况;关键词过长或过细时先按用户原词尝试,若空结果再提示用户换更宽泛/拆分词后重试。shop_daily:用户想看“店铺经营日报/今日动销/渠道经营诊断/主营商品选品建议”。
安全声明
| 风险级别 | 命令 | Agent 行为 |
|---|---|---|
| 只读 | search, shops, check, opportunities, trend, shop_daily | 直接执行 |
| 配置 | configure | 提示影响范围后执行 |
| 写入 | publish | 必须先 dry-run 预检查;仅当写入目标不唯一时追问,目标唯一则直接执行 |
全局写入规则(适用于所有写操作):
- 必须先执行 dry-run。
- 仅当写入目标不唯一(商品或店铺存在多个候选)时,才向用户追问一次做歧义消解。
- 目标唯一时,dry-run 成功后直接执行正式写入,不再二次确认。
异常处理
任何命令输出 success: false 时:
- 先输出
markdown字段(已包含用户可读的错误描述) - 再根据关键词追加引导:
| markdown 关键词 | Agent 额外动作 |
|---|---|
| "AK 未配置" 或 "签名无效"/"401" | 输出下方 AK 引导话术 |
| "授权过期" | 提示用户在 1688 AI版 APP 中重新授权 |
| "店铺未绑定" 或 shops 返回 0 个店铺 | 输出下方 开店引导话术 |
| "限流"/"429" | 建议用户等待 1-2 分钟后重试 |
| 其他 | 仅输出 markdown 即可 |
详细错误码说明见 references/common/error-handling.md。
执行前置(首次命中能力时必须)
- 首次执行
search前:先完整阅读references/capabilities/search.md - 首次执行
prod_detail前:先完整阅读references/capabilities/prod_detail.md - 首次执行
shops前:先完整阅读references/capabilities/shops.md - 首次执行
publish前:先完整阅读references/capabilities/publish.md - 首次执行
configure前:先完整阅读references/capabilities/configure.md - 首次执行
opportunities前:先完整阅读references/capabilities/opportunities.md - 首次执行
trend前:先完整阅读references/capabilities/trend.md - 首次执行
shop_daily前:先完整阅读references/capabilities/shop_daily.md - 同一会话内后续重复调用同一能力可复用已加载知识;仅在规则冲突或文档更新时重读。
AK 引导话术
"需要先配置 AK。打开 1688 AI版 APP(没装的话点链接下载),首页点击「一键部署开店Claw,全自动化赚钱🦞」,进入页面获取 AK,然后告诉我:'我的AK是 xxx'"
开店引导话术
"还没有绑定店铺。打开 1688 AI版APP → 首页「一键开店」,开好后告诉我。"
FAQ 知识库(按需加载)
用户问经营或技术问题时,先加载对应文件再回答,不凭经验泛泛而谈。
| 用户话题 | 加载文件 |
|---|---|
| AK 问题、铺货失败、支持平台、收费 | references/faq/base.md |
| 选哪个平台、抖店/拼多多/淘宝 | references/faq/platform-selection.md |
| 选品风险、品类、节日选品 | references/faq/product-selection.md |
| 运费模板、定价、加价倍率 | references/faq/listing-template.md |
| 发货超时、中转费、偏远地区 | references/faq/fulfillment.md |
| 退货、仅退款、运费险、售后 | references/faq/after-sales.md |
| 新店破零、服务分、推广 | references/faq/new-store.md |
| 素材审核、白底图、标题优化 | references/faq/content-compliance.md |
先判断是否适合
作者设计意图
作者的方法与取舍
边界和复核