@optima-chat/optima-agent 0.9.13 → 0.9.15

package/.claude/skills/product-page/SKILL.md

@@ -1,106 +1,106 @@
----
-name: product-page
-description: 商品详情页(PDP)配置。自定义商品详情页的区块内容（如护理说明、退货政策、品牌故事）。当用户需要编辑商品页信息区块、隐藏区块、添加自定义区块、管理翻译时使用。
----
-
-## 概念
-
-PDP（Product Detail Page）区块是商品详情页上的内容模块，采用三层继承：
-
-```
-System（系统默认 7 个区块）→ Merchant（商户定制）→ Product（单品覆盖）
-```
-
-- 无 `--product` → merchant 级（影响所有商品）
-- 有 `--product <id或handle>` → product 级（仅影响该商品）
-
-### 系统默认区块
-
-| handle | 说明 | 类型 |
-|--------|------|------|
-| `highlights` | 产品亮点 | static |
-| `details` | 产品详情 | collapsible |
-| `guarantee` | 品质保证 | collapsible |
-| `care` | 护理说明 | collapsible |
-| `shipping-policies` | 发货政策 | collapsible |
-| `return` | 退换政策 | collapsible |
-| `eco-friendly` | 环保说明 | collapsible |
-
-### 模板变量
-
-content 支持：`{{product.name}}`、`{{product.description}}`、`{{variant.sku}}`、`{{merchant.name}}`
-
-## 命令（共 7 个）
-
-### 查看
-
-```bash
-commerce pdp show                          # 所有区块（合并视图）
-commerce pdp show --product blue-hoodie    # 某商品的区块
-commerce pdp show --handle care            # 单个区块详情
-```
-
-### 添加新区块
-
-```bash
-commerce pdp add --handle faq --content "## FAQ\n\nQ1: ..." --type collapsible
-commerce pdp add --handle faq --content "..." --product blue-hoodie
-```
-
-### 编辑已有区块（自动覆盖系统默认）
-
-```bash
-commerce pdp edit --handle care --content "机洗30度"
-commerce pdp edit --handle care --content "干洗" --product silk-dress
-commerce pdp edit --handle care --position 3 --type static
-```
-
-### 隐藏区块
-
-```bash
-commerce pdp hide --handle eco-friendly
-commerce pdp hide --handle eco-friendly --product blue-hoodie
-```
-
-### 重置（删除定制，恢复继承）
-
-```bash
-commerce pdp reset --handle care --yes
-commerce pdp reset --handle care --product blue-hoodie --yes
-```
-
-### 排序（handle:position 格式，无 JSON）
-
-```bash
-commerce pdp reorder highlights:1 details:2 care:3 return:4
-commerce pdp reorder --tab-group product-info highlights:1 details:2
-commerce pdp reorder --product blue-hoodie highlights:1 details:2
-```
-
-### 翻译
-
-```bash
-# 设置
-commerce pdp translate --handle care --lang zh-CN --title "护理说明" --content "机洗30度"
-
-# 查看
-commerce pdp translate --handle care --list
-
-# 删除
-commerce pdp translate --handle care --lang zh-CN --delete --yes
-```
-
-## 自然语言映射
-
-- "查看商品详情页区块" → `commerce pdp show`
-- "修改护理说明" → `commerce pdp edit --handle care --content "..."`
-- "隐藏环保说明" → `commerce pdp hide --handle eco-friendly`
-- "添加品牌故事" → `commerce pdp add --handle brand-story --content "..."`
-- "调整区块顺序" → `commerce pdp reorder highlights:1 details:2 care:3`
-- "给护理说明加中文翻译" → `commerce pdp translate --handle care --lang zh-CN --title "..." --content "..."`
-
-## 注意
-
-- **PDP 管理页面区块**（内容板块），**product 管理商品属性**（名称、价格、库存）。两者不同。
-- 编辑继承的区块会自动创建 override，无需手动指定 operation-type
-- `--tab-group none` 可清除 tab 分组
+---
+name: product-page
+description: 商品详情页(PDP)配置。自定义商品详情页的区块内容（如护理说明、退货政策、品牌故事）。当用户需要编辑商品页信息区块、隐藏区块、添加自定义区块、管理翻译时使用。
+---
+
+## 概念
+
+PDP（Product Detail Page）区块是商品详情页上的内容模块，采用三层继承：
+
+```
+System（系统默认 7 个区块）→ Merchant（商户定制）→ Product（单品覆盖）
+```
+
+- 无 `--product` → merchant 级（影响所有商品）
+- 有 `--product <id或handle>` → product 级（仅影响该商品）
+
+### 系统默认区块
+
+| handle | 说明 | 类型 |
+|--------|------|------|
+| `highlights` | 产品亮点 | static |
+| `details` | 产品详情 | collapsible |
+| `guarantee` | 品质保证 | collapsible |
+| `care` | 护理说明 | collapsible |
+| `shipping-policies` | 发货政策 | collapsible |
+| `return` | 退换政策 | collapsible |
+| `eco-friendly` | 环保说明 | collapsible |
+
+### 模板变量
+
+content 支持：`{{product.name}}`、`{{product.description}}`、`{{variant.sku}}`、`{{merchant.name}}`
+
+## 命令（共 7 个）
+
+### 查看
+
+```bash
+commerce pdp show                          # 所有区块（合并视图）
+commerce pdp show --product blue-hoodie    # 某商品的区块
+commerce pdp show --handle care            # 单个区块详情
+```
+
+### 添加新区块
+
+```bash
+commerce pdp add --handle faq --content "## FAQ\n\nQ1: ..." --type collapsible
+commerce pdp add --handle faq --content "..." --product blue-hoodie
+```
+
+### 编辑已有区块（自动覆盖系统默认）
+
+```bash
+commerce pdp edit --handle care --content "机洗30度"
+commerce pdp edit --handle care --content "干洗" --product silk-dress
+commerce pdp edit --handle care --position 3 --type static
+```
+
+### 隐藏区块
+
+```bash
+commerce pdp hide --handle eco-friendly
+commerce pdp hide --handle eco-friendly --product blue-hoodie
+```
+
+### 重置（删除定制，恢复继承）
+
+```bash
+commerce pdp reset --handle care --yes
+commerce pdp reset --handle care --product blue-hoodie --yes
+```
+
+### 排序（handle:position 格式，无 JSON）
+
+```bash
+commerce pdp reorder highlights:1 details:2 care:3 return:4
+commerce pdp reorder --tab-group product-info highlights:1 details:2
+commerce pdp reorder --product blue-hoodie highlights:1 details:2
+```
+
+### 翻译
+
+```bash
+# 设置
+commerce pdp translate --handle care --lang zh-CN --title "护理说明" --content "机洗30度"
+
+# 查看
+commerce pdp translate --handle care --list
+
+# 删除
+commerce pdp translate --handle care --lang zh-CN --delete --yes
+```
+
+## 自然语言映射
+
+- "查看商品详情页区块" → `commerce pdp show`
+- "修改护理说明" → `commerce pdp edit --handle care --content "..."`
+- "隐藏环保说明" → `commerce pdp hide --handle eco-friendly`
+- "添加品牌故事" → `commerce pdp add --handle brand-story --content "..."`
+- "调整区块顺序" → `commerce pdp reorder highlights:1 details:2 care:3`
+- "给护理说明加中文翻译" → `commerce pdp translate --handle care --lang zh-CN --title "..." --content "..."`
+
+## 注意
+
+- **PDP 管理页面区块**（内容板块），**product 管理商品属性**（名称、价格、库存）。两者不同。
+- 编辑继承的区块会自动创建 override，无需手动指定 operation-type
+- `--tab-group none` 可清除 tab 分组

package/.claude/skills/querying-the-wiki/SKILL.md

@@ -1,59 +1,59 @@
----
-name: querying-the-wiki
-description: "从已有知识库中查询和回答问题。当用户提到的话题可能在 ~/kb/ 的某个知识库中有覆盖时使用。"
----
-
-# Querying The Wiki
-
-通过把维护后的 wiki 视为主要知识层来回答问题。
-
-## 启动 SOP
-
-1. `ls ~/kb/REGISTRY.md`
-   - 不存在 → 告诉用户"还没有知识库，需要先创建一个"，引导使用 initializing-kb
-2. 读 `~/kb/REGISTRY.md` — 获取所有 active 的 KB 列表
-3. 确定目标 KB：
-   - 用户明确指定了 KB slug 或主题 → 直接用
-   - 只有一个 active KB → 用它
-   - 多个 active → 根据用户问题匹配 `主题` + `说明` 字段；无法判断时列出让用户选
-4. 读 `~/kb/<slug>/AGENTS.md` 了解该 KB 的契约
-
-## 查询流程
-
-1. 读 `~/kb/<slug>/index.md`
-2. 找到最相关的 wiki 页面
-3. 优先基于维护后的页面回答
-4. 只有在 wiki 不完整或含混时才回到 raw sources
-5. 判断这个答案是否应该被保留
-6. 如果应该，写进 `~/kb/<slug>/wiki/analyses/` 或对应 overview 页面
-7. 追加 `~/kb/PROGRESS.md`
-8. `cd ~/kb && git add -A && git commit -m "[<slug>] query: <一句话>"`
-
-## Query 规则
-
-回答时：
-
-- 优先使用维护后的 wiki，而不是每次从头重建
-- 当答案依赖不完整或过时的 wiki 覆盖时，要说清楚
-- 把 source-backed 内容与综合推断区分开
-- 标出这个问题是否暴露了 wiki 的结构性空缺
-- 在答案中显式引用所使用的 wiki 页面；如果回看了 raw sources，也要说明
-
-## 何时保留结果
-
-在下列情况下，应把结果写回 wiki：
-
-- 同一个问题很可能会再次出现
-- 这个答案比较了多个来源或页面
-- 这个答案形成了可长期复用的综合
-- 这个答案解决了当前 wiki 尚未解释清楚的混乱点
-
-独立的长期输出应进入 `wiki/analyses/`。如果主要是改进某个主题的现有综述，则写入对应 overview 页面。
-
-## 最小交付标准
-
-一次成功的 query 至少应产出：
-
-- 一个直接回答用户问题的结果
-- 在答案中明确引用使用了哪些 wiki 页面
-- 清楚说明这个结果是否值得被保留
+---
+name: querying-the-wiki
+description: "从已有知识库中查询和回答问题。当用户提到的话题可能在 ~/kb/ 的某个知识库中有覆盖时使用。"
+---
+
+# Querying The Wiki
+
+通过把维护后的 wiki 视为主要知识层来回答问题。
+
+## 启动 SOP
+
+1. `ls ~/kb/REGISTRY.md`
+   - 不存在 → 告诉用户"还没有知识库，需要先创建一个"，引导使用 initializing-kb
+2. 读 `~/kb/REGISTRY.md` — 获取所有 active 的 KB 列表
+3. 确定目标 KB：
+   - 用户明确指定了 KB slug 或主题 → 直接用
+   - 只有一个 active KB → 用它
+   - 多个 active → 根据用户问题匹配 `主题` + `说明` 字段；无法判断时列出让用户选
+4. 读 `~/kb/<slug>/AGENTS.md` 了解该 KB 的契约
+
+## 查询流程
+
+1. 读 `~/kb/<slug>/index.md`
+2. 找到最相关的 wiki 页面
+3. 优先基于维护后的页面回答
+4. 只有在 wiki 不完整或含混时才回到 raw sources
+5. 判断这个答案是否应该被保留
+6. 如果应该，写进 `~/kb/<slug>/wiki/analyses/` 或对应 overview 页面
+7. 追加 `~/kb/PROGRESS.md`
+8. `cd ~/kb && git add -A && git commit -m "[<slug>] query: <一句话>"`
+
+## Query 规则
+
+回答时：
+
+- 优先使用维护后的 wiki，而不是每次从头重建
+- 当答案依赖不完整或过时的 wiki 覆盖时，要说清楚
+- 把 source-backed 内容与综合推断区分开
+- 标出这个问题是否暴露了 wiki 的结构性空缺
+- 在答案中显式引用所使用的 wiki 页面；如果回看了 raw sources，也要说明
+
+## 何时保留结果
+
+在下列情况下，应把结果写回 wiki：
+
+- 同一个问题很可能会再次出现
+- 这个答案比较了多个来源或页面
+- 这个答案形成了可长期复用的综合
+- 这个答案解决了当前 wiki 尚未解释清楚的混乱点
+
+独立的长期输出应进入 `wiki/analyses/`。如果主要是改进某个主题的现有综述，则写入对应 overview 页面。
+
+## 最小交付标准
+
+一次成功的 query 至少应产出：
+
+- 一个直接回答用户问题的结果
+- 在答案中明确引用使用了哪些 wiki 页面
+- 清楚说明这个结果是否值得被保留