@shulex/cxclawctl 0.1.2 → 0.1.4

package/skills/delivery/interfaces/create-agents.md

@@ -1,89 +0,0 @@
-# Delivery Intent And Agent Creation
-
-Delivery 专属能力：创建正式交付意图，优先复制固定广场 agent，绑定策略，并默认更新订单工具 X-Token。
-
-## Commands
-
-```bash
-npx --yes @shulex/cxclawctl@latest script skills/delivery/scripts/create_agents.py --mode delivery
-
-# Delivery 恢复阶段：预置 agent 不可用，用户确认从零新建或使用替代 agent 后，绑定业务策略
-npx --yes @shulex/cxclawctl@latest script skills/delivery/scripts/create_agents.py --mode delivery \
-  --custom-agent-map /workspace/state/delivery/custom_agent_map.json
-
-# 创建后禁用多余 SYSTEM 意图
-npx --yes @shulex/cxclawctl@latest script skills/delivery/scripts/create_agents.py --disable-system
-```
-
-`custom_agent_map.json` 使用 Delivery intent 名作为 key：
-
-```json
-{
-  "Pre-Sales Inquiry": 2642,
-  "Product issues": 2643
-}
-```
-
-## Flow
-
-1. 通过 `/skills/delivery/interfaces/classify.md` 完成分类。
-2. 展示分类结果，等用户确认。
-3. 执行 `/skills/delivery/scripts/create_agents.py --mode delivery`。
-4. 读取 `/workspace/state/delivery/progress.json` 的 `created_log_path`。
-5. 读取 created log，展示意图、agent、strategy。
-6. 说明 skipped 项：
-   - 新 L1：已创建意图，但没有固定广场 agent 映射，需要人工配置 agent 或复用已有 agent。
-   - 标准 L1 的 `preset_agent_errors`：默认 squareAgent 不可用，不要直接崩溃或要求开发修复；询问客户是从零新建 CHAT_FLOW agent，还是使用其他现有 agent 替代。
-7. 用户确认新建或替代后，把已确认的 agent id 写入 `custom_agent_map.json`，执行 `--custom-agent-map` 绑定业务策略；没有确认前不要盲目绑定策略。
-8. 询问是否需要 `--disable-system` 关闭多余 SYSTEM 意图。
-
-## Guarantees
-
-- 创建 7 个标准意图和分类中新发现的 L1。
-- 当前租户已有同名意图时复用现有意图 id，继续创建 agent 和策略；不要因为 create intent 返回同名冲突而中断。
-- 7 个标准意图优先按固定 binding 克隆 agent。
-- 固定 squareAgent 不可用时，记录为可恢复 skipped 项，询问从零新建或使用替代 agent。
-- 预置或替代 agent 可用后，1 个意图绑定 1 条策略。
-- 默认更新订单工具 X-Token。
-
-## Delivery Fixed Bindings
-
-| L1 Intent | L2 子意图（预定义） | 默认 squareAgent_id |
-|---|---|---|
-| Pre-Sales Inquiry | Product Recommendation, Discount Inquiry, Price Inquiry, Stock Availability, Payment Issues | 37625 |
-| Invoices | Request Invoice, Modify Invoice Information | 37627 |
-| Order Issues | Modify Order, Check Order Status, Cancel Order | 37631 |
-| Logistics Issues | Track Shipment, Shipping Exception | 37633 |
-| Package issues | Missing Items, Wrong Items Received, Damaged Package | 37623 |
-| Product issues | Product Usage, Physical Damage, Non-Physical Issues | 38114 |
-| Return and exchange | 从数据中推断，无 xlsx 时为空 | 37626 |
-
-默认 `squareAgent_id` 只是首选来源，不是硬阻塞依赖。找不到时按可恢复 skipped 项处理。
-
-## Outputs
-
-状态文件：`/workspace/state/delivery/progress.json`。
-
-可读取：
-
-- `status`
-- `mode`
-- `created_log_path`
-- `updated_at`
-
-`created_log_path` 指向 JSON，可读取：
-
-- `intents[]`
-- `intents[].intent_name`
-- `intents[].intent_id`
-- `intents[].agent_id`
-- `intents[].strategy_id`
-- `intents[].skipped`
-- `intents[].skip_reason`
-- `preset_agent_errors[]`
-- `next_action`
-- `custom_agent_strategies[]`
-
-## Non-Guarantees
-
-- 策略 API payload、copyAgent payload 不对上层流程暴露。

package/skills/delivery/interfaces/delivery-test.md

@@ -1,67 +0,0 @@
-# Delivery Test
-
-Delivery 专属回归能力：正式交付前按上传用例或历史抽样执行批量回归，输出 KPI HTML + MD。
-
-这份 interface 属于 `delivery` skill。Delivery 回归 runner 和报告渲染器都在本 skill 内。
-
-## Commands
-
-```bash
-# 历史抽样
-npx --yes @shulex/cxclawctl@latest script skills/delivery/scripts/sample_history_cases.py \
-  --total 100 \
-  --intents "Order Issues" \
-  --output /workspace/outputs/delivery/cases_<ts>.json
-
-# 批量回归
-npx --yes @shulex/cxclawctl@latest script skills/delivery/scripts/batch_test.py \
-  --input /workspace/outputs/delivery/cases_<ts>.json \
-  --output /workspace/outputs/delivery/results_<ts>.json \
-  --touch-point LIVE_CHAT \
-  --workers 10 \
-  --partial /workspace/state/delivery/partial_results.json \
-  --report
-```
-
-## Inputs
-
-- 用户上传的 xlsx/csv/json，调用前必须物化文件。
-- 或历史抽样生成的 `cases.json`。
-- `touch-point`：默认 `LIVE_CHAT`，按用户要求可用 `EMAIL`。
-
-## Flow
-
-1. 确认数据来源：用户上传，或按意图从历史会话抽样。
-2. 确认 touch-point。
-3. 执行 `batch_test.py`。
-4. 如中断，基于 partial 续跑未完成 case。
-5. 读取结果并展示核心 KPI。
-6. 更新 `/workspace/state/delivery/progress.json`。
-
-## Outputs
-
-- `results_<ts>.json`
-- `results_<ts>.json.html`
-- `results_<ts>.json.md`
-- partial：`/workspace/state/delivery/partial_results.json`
-
-## State
-
-Delivery 顶层状态写 `/workspace/state/delivery/progress.json`：
-
-- `regression.input_path`
-- `regression.touch_point`
-- `regression.results_path`
-- `regression.report_html`
-- `regression.report_md`
-
-## Behavior Guarantees
-
-- Delivery 回归支持 partial 续跑。
-- `--report` 输出 HTML + MD。
-- EMAIL 模式内部处理异步轮询，调用方不要额外加 sleep。
-
-## Non-Guarantees
-
-- 报告 HTML 模板结构不保证稳定。
-- batch runner 并发实现不对 Delivery 暴露。

package/skills/delivery/references/flow.md

@@ -1,40 +0,0 @@
-# Delivery 流程
-
-## 阶段一：意图分类与正式 agent 创建
-
-1. 通过 `delivery/interfaces/classify.md` 完成分类。
-2. 展示分类结果，等用户确认。
-3. 通过 `delivery/interfaces/create-agents.md` 执行 Delivery 创建：
-   - 创建或复用 7 个标准意图 + 新发现 L1。
-   - 优先按固定 binding 克隆广场 agent。
-   - 如果固定广场 agent 找不到，询问用户从零新建还是使用其他现有 agent 替代，不要直接中断等待研发修复。
-   - 预置可用时自动绑定策略。
-   - 用户确认替代方案后，通过 `--custom-agent-map` 将自定义/替代 agent 按意图写入策略。
-   - 默认更新订单工具 X-Token。
-4. 展示 intent / agent / strategy 表，等用户确认。
-
-## 阶段二：知识库搭建
-
-Delivery 默认需要知识库；如果用户说明已完成，先通过 `list-directories` / `list-knowledge` 验证，不依赖本地 `kb_progress.json`。
-
-1. 网页、官网、帮助中心：通过 `kb-builder/interfaces/web-kb.md`。
-2. 现成 `qa_plan.json` 或 QA parts：通过 `kb-builder/interfaces/qa-upload.md`。
-3. PDF / xlsx / 模板 / 导出等非网页能力仍归 `kb-builder` 自己判断，Delivery 不维护这些内部细节。
-
-## 阶段三：批量回归测试
-
-通过 `delivery/interfaces/delivery-test.md` 执行：
-
-- 历史抽样出 cases。
-- 或客户上传 xlsx/csv/json。
-- `LIVE_CHAT` 默认，`EMAIL` 可选。
-- 支持 partial 续跑。
-- 输出 KPI HTML + MD。
-
-## 交付物
-
-- 意图分类报告（HTML / Excel）。
-- 7 个标准意图 + agent + strategy。
-- X-Token 已更新的订单工具。
-- 完整知识库。
-- KPI 回归报告（HTML + MD）。

package/skills/delivery/references/validation.md

@@ -1,15 +0,0 @@
-# Delivery 验证清单
-
-## 基础验证
-
-- `/delivery` 空参数会询问起点。
-- “接着上次”会优先读取 `/workspace/state/delivery/progress.json`。
-- 顶层 state 只保存路径引用。
-
-## 阶段验证
-
-- xlsx 分类路径可生成报告。
-- Delivery 创建默认更新 X-Token。
-- 知识库阶段为必做，除非用户明确确认已有并通过后端状态验证。
-- 回归测试支持历史抽样和上传用例。
-- partial 续跑由 delivery runner 负责。