sensecraft-solutions: Skill for Claude Code

Solution Copywriting Skill

调用方式

/solution-copywriting smart_warehouse                    # 全面检查
/solution-copywriting smart_warehouse 介绍页术语太专业    # 指定修改方向
/solution-copywriting smart_warehouse 部署步骤不清晰
/solution-copywriting smart_warehouse 添加故障排查表格

参数说明

• $0 = solution_id（必填）
• $1... = 修改方向（可选，自然语言描述）

执行流程

Step 1: 读取方案文件

• solutions/$0/solution.yaml
• solutions/$0/description.md + solutions/$0/description_zh.md
• solutions/$0/guide.md + solutions/$0/guide_zh.md

如果指定了修改方向 ($1): 优先按用户指定方向修改，跳过无关检查项。

Step 2: 介绍页检查（对照下方「一、介绍页文案标准」）

• 有「这个方案能帮你做什么」段落？
• 有「核心价值」表格？
• 有「适用场景」示例？
• 有「使用须知」限制说明？
• 专业术语已替换？
• 设备名称具体、不泛指？
• 设备描述只写功能、不贴产品定位标签？
• 技术工具名已转为用户价值描述？

根据 solution_type 的额外检查：

如果 solution_type: technical（技术演示）：

• 首屏先讲「能接到什么系统、解决什么能力缺口」，不是先贴端口/API 表？
• 有「部署后你会得到什么」或等价段落？（把接口翻译成用户能理解的产物）
• 有接口段落？（说明产出什么数据、什么协议、什么格式；如前端已自动展示 output_interfaces，正文只做通俗解释）
• curl/代码示例放在部署完成、接口详情或 guide.md 中，不要放在介绍页首屏？
• 核心价值聚焦在「能力」而非「业务流程」？
• 没有过度包装成完整业务方案？

如果 solution_type: solution（完整方案）：

• 有用户操作界面/仪表板的描述或截图？
• 适用场景描述的是完整业务流程（而非单一技术能力）？
• 有「部署效果」段落让用户预知部署后能看到什么？

Step 3: 部署页检查（对照下方「三、部署页文案标准」）

• 每个步骤有 ### 接线 / ### Wiring 子节？
• 每个步骤有 ### 故障排查 / ### Troubleshooting 子节？
• 中英文步骤 ID（{#...} 部分）完全一致？
• 中文关键词严格使用规范写法？（### 部署目标: 不是 ### 目标:，### 故障排查 不是 ### 排错——完整对照表见下方「子节识别规则」表）
• 成功页内容完整？
• 尖括号占位符已正确处理？裸文本中 <device-ip> → \<device-ip\>；backtick 内和 fenced code block 内不要转义（反斜杠会原样显示）

Step 4: 输出改进报告

• 按 P0/P1/P2 分类问题
• 提供修改建议或直接修改

---

概述

本 Skill 用于创建或优化 solutions/ 目录下的解决方案文案，确保：

• 非技术用户能在 30 秒内理解方案价值
• 部署步骤清晰可执行，不卡壳、不出错
• 用词通俗易懂，避免专业术语

---

一、介绍页文案标准

目标

帮助非技术用户在 30 秒内理解：这个方案解决什么问题？对我有什么好处？

文件位置

使用分离格式（每种语言独立文件）：

solutions/[id]/
├── description.md      # 英文介绍页
└── description_zh.md   # 中文介绍页

结构模板（必须包含以下 4 个部分）

## 这个方案能帮你做什么

[用 1-2 句话，用通俗语言描述痛点和解决方案]

示例：
- ✓ "仓库管理系统功能强大，但上手成本高——要培训、要记菜单。这个方案把复杂操作变成说话，开口就会用。"
- ✗ "本方案通过集成视觉识别模块实现多模态人机交互能力增强。"

## 核心价值

用 3-4 个要点说明好处，每个要点：
- 用「动词 + 具体结果」的格式
- 附带可量化的指标或具体场景

| 好处 | 具体说明 |
|------|---------|
| 零学习成本 | 不用培训、不用记菜单，开口说话就能操作系统 |
| 数据实时准确 | 直接查询数据库，库存数据实时更新 |
| 数据安全可控 | 支持纯本地部署，数据不出厂区 |

## 适用场景

列出 3-4 个具体应用场景，每个场景包含：
- **场景名称**：一句话描述
- **使用示例**：具体的操作或对话

| 场景 | 怎么用 |
|------|--------|
| 收货入库 | 说"入库 5 台 Watcher"，系统自动登记 |
| 叉车作业 | 司机说"A3 货架还有多少货"，语音播报，不用下车 |

## 使用须知

按以下顺序组织内容：

### 核心硬件设备（必需，显示在架构图之前）

| 设备 | 说明 | 必需 |
|------|------|------|
| SenseCAP Watcher | AI 语音助手 | ✓ 必选 |
| reComputer R1100/R2000 | 边缘网关（两款均支持） | ✓ 必选 |
| NVIDIA AGX Orin | 本地 AI 计算 | 边缘方案需要 |

### 网络要求（必需，显示在架构图之前）

- Watcher 需连接 2.4GHz WiFi（不支持 5GHz）
- 云方案需要互联网，边缘方案可断网运行