@shulex/cxclawctl 0.1.2 → 0.1.3

package/skills/delivery/scripts/gen_report.py

@@ -1,208 +0,0 @@
-"""
-HTML report generator for delivery skill.
-
-Reads classification results (workspace/state/delivery/progress.json -> results_path) and
-renders a polished HTML report under workspace/outputs/delivery/.
-
-Usage:
-  python3 scripts/gen_report.py [--brand "Acme"]
-"""
-
-import os, sys
-sys.path.insert(0, os.path.join(os.environ.get("SOLVEA_LIB_DIR", os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "..", "__lib__"))), "skill-runtime"))
-from bootstrap import *
-
-import json, argparse
-from uuid import uuid4
-
-
-def _read_state() -> dict:
-    _sf = STATE_DIR / "progress.json"
-    if _sf.exists():
-        try:
-            return json.loads(_sf.read_text(encoding="utf-8"))
-        except Exception:
-            pass
-    return {}
-
-
-def _write_state(data: dict) -> None:
-    _sf = STATE_DIR / "progress.json"
-    _sf.parent.mkdir(parents=True, exist_ok=True)
-    _sf.write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
-
-from render import render_html
-
-COLOR_PALETTE = [
-    "#ef4444", "#f97316", "#eab308", "#22c55e",
-    "#14b8a6", "#3b82f6", "#8b5cf6", "#ec4899",
-    "#06b6d4", "#84cc16",
-]
-
-CIRCLE_NUMS = "①②③④⑤⑥⑦⑧⑨⑩"
-
-
-def build_config_from_results(results, brand_name=""):
-    def uid():
-        return uuid4().hex
-
-    agents = []
-    all_intents = results.get("intents", []) + results.get("new_intents", [])
-    meta = results.get("meta", {})
-    total = meta.get("total", 0)
-
-    for i, intent in enumerate(all_intents):
-        sub_intents = intent.get("sub_intents", [])
-        is_new = intent.get("is_new", False)
-        agent_id = f"intent-{i}"
-
-        l2_nodes = []
-        for j, s in enumerate(sub_intents):
-            sample_preview = s["samples"][0][:50] + "..." if s.get("samples") else ""
-            l2_nodes.append({
-                "id": f"n2-{uid()[:8]}",
-                "name": s["name"],
-                "desc": f"{s['pct']:.1f}% — {sample_preview}" if sample_preview else f"{s['pct']:.1f}%",
-                "count": s["count"],
-                "definition": s.get("definition", ""),
-                "is_shared": False,
-                "shared_agents": [],
-                "samples": s.get("samples", []),
-            })
-
-        nodes_ac = []
-        for s in sub_intents[:3]:
-            nodes_ac.append({
-                "name": f"节点 · {s['name']}",
-                "trigger": f"客户投诉：{s['name']}",
-                "action": f"<code>LLM</code> 处理 {s['name']}，引导解决",
-            })
-
-        agents.append({
-            "id": agent_id,
-            "name": f"{CIRCLE_NUMS[i % len(CIRCLE_NUMS)]} {intent['name']}",
-            "color": COLOR_PALETTE[i % len(COLOR_PALETTE)],
-            "l1_intents": [intent["name"]],
-            "total_count": intent["count"],
-            "total_pct": intent["pct"],
-            "is_new": is_new,
-            "intent_config": {
-                "definition": intent.get("definition", ""),
-                "excludes": [],
-                "examples": intent.get("samples", [])[:3],
-                "covers": [s["name"] for s in sub_intents],
-            },
-            "agent_config": {
-                "type": "chatflow",
-                "nodes": nodes_ac,
-                "footer": f"<b>结束：</b>解决{intent['name']}问题 / 转人工",
-            },
-            "l2_nodes": l2_nodes,
-        })
-
-    edges = []
-    for a in agents:
-        ag_html_id = f"ag-{a['id'].replace('_', '-')}"
-        color = a.get("color", "#6b7280")
-        for node in a["l2_nodes"]:
-            count = node.get("count", 0)
-            if count > 0:
-                edges.append({"from": ag_html_id, "to": node["id"], "count": count, "color": color})
-
-    total_nodes = sum(len(a["l2_nodes"]) for a in agents)
-    n_known = meta.get("n_known", len(results.get("intents", [])))
-    n_new = meta.get("n_new", len(results.get("new_intents", [])))
-
-    rows = []
-    for a in agents:
-        n = len(a["l2_nodes"])
-        badge = f"{n} 节点 ✓" if n <= 2 else (f"{n} 节点 ⚠️" if n <= 3 else f"{n} 节点 ❌")
-        rows.append({
-            "agent_name": a["name"],
-            "color": a["color"],
-            "node_count": n,
-            "badge": badge,
-        })
-
-    l2_total = sum(s["count"] for intent in all_intents for s in intent.get("sub_intents", []))
-    opt_notes = (
-        f"✅ 已知意图 {n_known} 个，新发现意图 {n_new} 个，共 {n_known + n_new} 个 L1 意图\n\n"
-        f"📊 数据基础：{total:,} 条对话 / L2 分类：{l2_total:,} 条"
-    )
-    if n_new > 0:
-        new_names = [i["name"] for i in results.get("new_intents", [])]
-        opt_notes += f"\n\n⚡ 新发现意图：{' · '.join(new_names)}"
-
-    return {
-        "agents": agents,
-        "filter_block": {"types": ["未分类投诉"], "count": 0},
-        "node_summary": {
-            "rows": rows,
-            "total_nodes": total_nodes,
-            "optimization_notes": opt_notes,
-        },
-        "shared_nodes": [],
-        "edges": edges,
-    }
-
-
-def _resolve_results_path(state: dict) -> str:
-    path = state.get("results_path")
-    if not path:
-        raise FileNotFoundError(
-            "No results_path in state. Run classify.py first."
-        )
-    if not os.path.exists(path):
-        raise FileNotFoundError(
-            f"Results file missing: {path}. Run classify.py first."
-        )
-    return path
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Generate delivery intent classification HTML report")
-    parser.add_argument("--brand", default="")
-    parser.add_argument("--results", default=None,
-                        help="Override results JSON path (default: read from progress.json)")
-    args = parser.parse_args()
-
-    if args.results:
-        results_path = args.results
-        if not os.path.exists(results_path):
-            raise FileNotFoundError(f"Results file missing: {results_path}")
-    else:
-        state = _read_state()
-        results_path = _resolve_results_path(state)
-
-    with open(results_path) as f:
-        results = json.load(f)
-
-    config = build_config_from_results(results, brand_name=args.brand)
-
-    meta = results.get("meta", {})
-    data_compat = {
-        "_meta": {"total": meta.get("total", 0), "brand": args.brand},
-        "tree": {},
-        "turn_distribution": {},
-        "fuzzy_samples": {},
-    }
-
-    project_id = os.environ.get("SOLVEA_PROJECT_ID", "")
-    html = render_html(config, data_compat, brand=args.brand, project_id=project_id)
-
-    OUTPUTS_DIR.mkdir(parents=True, exist_ok=True)
-    report_path = str(OUTPUTS_DIR / f"report_{timestamp()}.html")
-    with open(report_path, "w", encoding="utf-8") as f:
-        f.write(html)
-    print(f"[gen_report] Report -> {report_path}")
-
-    state = _read_state()
-    state["report_path"] = report_path
-    state["updated_at"] = timestamp()
-    _write_state(state)
-
-    print(f"[gen_report] Done.")
-
-
-if __name__ == "__main__":
-    main()

package/skills/delivery/scripts/plan.py

@@ -1,163 +0,0 @@
-#!/usr/bin/env python3
-"""Delivery 顶层状态规划器。
-
-只维护 `/workspace/state/delivery/progress.json`，不执行 intent / KB / batch
-等底层能力。其他 skill 的状态只通过路径引用记录在本文件中。
-"""
-import os, sys
-sys.path.insert(0, os.path.join(os.environ.get("SOLVEA_LIB_DIR", os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "..", "__lib__"))), "skill-runtime"))
-from bootstrap import *  # noqa: F401,F403
-
-import argparse
-import json
-from datetime import datetime, timezone
-from typing import Any
-
-
-STATE_FILE = STATE_DIR / "progress.json"
-
-STATUS_ORDER = [
-    "empty",
-    "classified",
-    "agents_created",
-    "kb_done",
-    "regression_done",
-    "done",
-]
-
-
-def default_state() -> dict[str, Any]:
-    return {
-        "status": "empty",
-        "tenant": SOLVEA_TENANT_ID or "",
-        "brand_name": "",
-        "intent": {
-            "progress_path": "/workspace/state/delivery/progress.json",
-            "classification_report_path": "",
-            "classification_excel_path": "",
-            "created_log_path": "",
-        },
-        "kb": {
-            "required": True,
-            "source_url": "",
-            "directory_plan_path": "",
-            "qa_plan_path": "",
-            "upload_result_path": "",
-        },
-        "regression": {
-            "input_path": "",
-            "touch_point": "LIVE_CHAT",
-            "results_path": "",
-            "report_html": "",
-            "report_md": "",
-        },
-        "updated_at": "",
-    }
-
-
-def merge_dict(base: dict[str, Any], patch: dict[str, Any]) -> None:
-    for key, value in patch.items():
-        if isinstance(value, dict) and isinstance(base.get(key), dict):
-            merge_dict(base[key], value)
-        else:
-            base[key] = value
-
-
-def read_state() -> dict[str, Any]:
-    if not STATE_FILE.exists():
-        return default_state()
-    try:
-        loaded = json.loads(STATE_FILE.read_text(encoding="utf-8"))
-    except Exception:
-        return default_state()
-    state = default_state()
-    merge_dict(state, loaded)
-    return state
-
-
-def write_state(state: dict[str, Any]) -> None:
-    state["updated_at"] = datetime.now(timezone.utc).isoformat()
-    STATE_FILE.parent.mkdir(parents=True, exist_ok=True)
-    STATE_FILE.write_text(json.dumps(state, ensure_ascii=False, indent=2), encoding="utf-8")
-
-
-def set_path(state: dict[str, Any], dotted_key: str, raw_value: str) -> None:
-    parts = [p for p in dotted_key.split(".") if p]
-    if not parts:
-        raise ValueError("empty key")
-    cur = state
-    for part in parts[:-1]:
-        nxt = cur.get(part)
-        if not isinstance(nxt, dict):
-            nxt = {}
-            cur[part] = nxt
-        cur = nxt
-    value: Any = raw_value
-    if raw_value.lower() == "true":
-        value = True
-    elif raw_value.lower() == "false":
-        value = False
-    elif raw_value.startswith("[") or raw_value.startswith("{"):
-        value = json.loads(raw_value)
-    cur[parts[-1]] = value
-
-
-def recommendation(status: str) -> str:
-    return {
-        "empty": "下一步：读取 delivery/interfaces/classify.md，确认从 xlsx 分类还是固定 7 意图开始。",
-        "classified": "下一步：展示分类结果并等待用户确认；确认后调用 /skills/delivery/scripts/create_agents.py --mode delivery。",
-        "agents_created": "下一步：进入 KB 阶段；如用户声称已有 KB，先 list-directories / list-knowledge 验证。",
-        "kb_done": "下一步：读取 delivery/interfaces/delivery-test.md，确认回归数据来源和 touch-point。",
-        "regression_done": "下一步：汇总 KPI 报告和失败明细，确认交付完成。",
-        "done": "当前 Delivery 已完成；如需重跑，请明确要重跑的阶段。",
-    }.get(status, "状态未知：请检查 progress.json。")
-
-
-def main() -> None:
-    parser = argparse.ArgumentParser(description="Delivery top-level progress planner")
-    parser.add_argument("--init", action="store_true", help="Create progress.json if missing")
-    parser.add_argument("--status", choices=STATUS_ORDER, help="Update top-level status")
-    parser.add_argument("--tenant", default=None)
-    parser.add_argument("--brand-name", default=None)
-    parser.add_argument("--set", action="append", default=[], metavar="KEY=VALUE",
-                        help="Set a dotted state path, e.g. intent.created_log_path=/workspace/...")
-    parser.add_argument("--json", action="store_true", help="Print JSON only")
-    args = parser.parse_args()
-
-    existed = STATE_FILE.exists()
-    state = read_state()
-    changed = False
-
-    if args.init and not existed:
-        changed = True
-    if args.status:
-        state["status"] = args.status
-        changed = True
-    if args.tenant is not None:
-        state["tenant"] = args.tenant
-        changed = True
-    if args.brand_name is not None:
-        state["brand_name"] = args.brand_name
-        changed = True
-    for item in args.set:
-        if "=" not in item:
-            raise SystemExit(f"--set expects KEY=VALUE, got: {item}")
-        key, value = item.split("=", 1)
-        set_path(state, key, value)
-        changed = True
-
-    if changed:
-        write_state(state)
-
-    if args.json:
-        print(json.dumps(state, ensure_ascii=False, indent=2))
-        return
-
-    print(f"Delivery progress: {STATE_FILE}")
-    print(f"status={state.get('status')} tenant={state.get('tenant') or '-'} brand={state.get('brand_name') or '-'}")
-    print(recommendation(str(state.get("status") or "")))
-    print(json.dumps(state, ensure_ascii=False, indent=2))
-
-
-if __name__ == "__main__":
-    main()