OneClear

把销售转述、客户原话、现场工况和报价压力，整理成一份可推进、可追问、可控风险的工业除尘滤料售前判断。

OneClear 是一个面向工业除尘滤料售前技术支持的 Agent Skill。它不是通用销售话术工具，而是帮助 Claude Code、Codex、OpenCode、Cursor 等 agent 处理真实售前场景中的复杂输入：客户只说“压差高”“寿命短”“竞品太贵”“能不能报价”，销售只转述半句话，但技术支持必须先判断真实工况问题、缺失信息、风险边界和下一步追问。

npx skills add skip53/oneclear-skill

安装后可通过 $oneclear 调用。

Install

推荐使用 Skills CLI 从 GitHub 安装：

npx skills add skip53/oneclear-skill

只安装到指定 agent 时，可使用 Skills CLI 的 agent 参数，例如：

npx skills add skip53/oneclear-skill -a claude-code
npx skills add skip53/oneclear-skill -a codex
npx skills add skip53/oneclear-skill -a opencode
npx skills add skip53/oneclear-skill -a cursor

非交互安装：

npx skills add skip53/oneclear-skill --skill oneclear -g -a claude-code -y

npm Installer Fallback

OneClear 也提供 npm fallback 安装器：

npx oneclear install

默认安装到：

| Agent | 安装位置 | |---|---| | Codex | ~/.codex/skills/oneclear | | Claude Code | ~/.claude/skills/oneclear | | OpenCode | ~/.config/opencode/skills/oneclear | | Cursor | 当前项目的 .cursor/skills/oneclear |

指定目标：

npx oneclear install --target codex
npx oneclear install --target claude
npx oneclear install --target opencode
npx oneclear install --target cursor
npx oneclear install --target codex,cursor

Cursor 默认安装到当前目录下的 .cursor/skills/oneclear；如需指定项目目录：

npx oneclear install --target cursor --project-dir /path/to/project

已有安装时覆盖：

npx oneclear install --force

预览安装位置，不写入文件：

npx oneclear install --dry-run

不要使用 npx install oneclear。在 npm/npx 语义中，这会尝试运行名为 install 的包或命令，而不是运行 oneclear。正确形式是：

npx oneclear install

What It Does

| 能力 | 输出 | 典型用途 | |---|---|---| | 工况档案整理 | 八块工况档案草稿 | 把零散客户原话、销售转述、已知/未知/矛盾信息结构化 | | 案件分流 | 新项目选型 / 旧项目故障 / 替换降本 / 信息不足 | 避免还没搞清楚问题就进入报价或选型 | | 真实需求判断 | 表层诉求 vs 真实工况问题 vs 商业目标 | 识别“想便宜一点”背后的稳定性、寿命、排放或停机风险 | | 风险标签 | 温度、含湿、腐蚀、磨蚀、糊袋、火星、清灰、压差等 | 提醒销售不要遗漏关键风险 | | 追问清单 | 3-7 个 P0/P1 问题，含内部技术版和客户转述版 | 让销售知道下一轮该问什么、怎么问 | | 报价准备度 | 不可报价 / 预算报价 / 人工确认后正式报价候选 | 防止“先报个价”变成技术承诺 | | Level 4/5 售前包 | 候选方向、证据要求、试用边界、禁止承诺、人工确认 | 支撑竞品替换、试用验证、招投标、复杂项目推进 |

Example Prompts

$oneclear 客户说水泥窑尾滤袋半年就压差高，清灰下不来，怀疑我们材料质量有问题。销售想让我直接给替换方案。

$oneclear 客户现在用竞品 PTFE 覆膜袋，觉得价格高，想换便宜一点。工况只知道是垃圾焚烧，排放要求 10mg 以下。

$oneclear 这是一个新建项目，客户问我们能不能直接报价。已知温度 160-190℃，粉尘细，含湿没说，目标寿命两年。

Core Mechanics

1. 先判断真实问题，再谈方案

OneClear 的最高优先级是：

客户问题真实 > 技术方案可行 > 商业价值明确 > 风险透明 > 推进成交

它会先区分客户原话、销售转述、已知事实、未知事实和矛盾点，而不是把“客户想报价”“客户说质量问题”“客户要便宜”直接当成真实需求。

2. 用 Level 控制承诺边界

OneClear 使用 0-5 级判断梯度：

| Level | 含义 | 输出边界 | |---|---|---| | 0 | 无法分流 | 只能问最小澄清问题 | | 1 | 可分流，不可诊断 | 可给案件类型和追问路径 | | 2 | 可初步诊断，不可选型 | 可给风险标签和证据需求 | | 3 | 可给选型方向，不可确定型号 | 可谈方向，不给最终型号 | | 4 | 可给候选方案，需人工确认 | 可给 1-3 个候选方向和验证边界 | | 5 | 可形成技术支持包 | 可形成客户需求摘要、风险假设、候选方向、试用计划和下一步动作 |

3. 脚本只做护栏，不替代专家判断

scripts/ 中包含确定性检查器，用来辅助分类、缺失字段检查、风险标签、输出包校验和规则库评估。脚本输出不是最终选型授权；当脚本和参考文档冲突时，取更严格的承诺边界。

4. 售前推进和技术判断放在同一张图里

OneClear 不只判断材料，还会检查决策链、报价准备度、竞品压力、试用验证边界、商业价值量化和内部升级包需求。目标是让销售下一步能推进，而不是拿到一份无法对外使用的技术碎片。

Works With

推荐通过 npx skills add skip53/oneclear-skill 安装，Skills CLI 会处理多 agent 兼容。OneClear 当前面向：

| Agent | 推荐方式 | 备注 | |---|---|---| | Claude Code | npx skills add skip53/oneclear-skill -a claude-code | 也支持 npm fallback 到 ~/.claude/skills/oneclear | | Codex | npx skills add skip53/oneclear-skill -a codex | 也支持 npm fallback 到 ~/.codex/skills/oneclear | | OpenCode | npx skills add skip53/oneclear-skill -a opencode | npm fallback 到 ~/.config/opencode/skills/oneclear | | Cursor | npx skills add skip53/oneclear-skill -a cursor | npm fallback 到当前项目 .cursor/skills/oneclear |

Limitations

• OneClear 不替代最终专家签字、现场检查、实验室检测、合同技术承诺或质保承诺。
• 信息不足时，它会降级为追问和风险提示，不会强行推荐具体材料型号。
• 对排放、寿命、替换效果、竞品优劣、招投标响应等内容，会保留人工确认和禁止承诺项。
• npm fallback 的 Cursor 安装是项目级安装；如果希望跨项目复用，优先使用 npx skills add ... 的全局安装能力。

Repository Structure

oneclear-skill/
├── SKILL.md                  # Skill 主入口，定义触发条件、流程、承诺边界
├── agents/
│   └── openai.yaml           # Agent UI 元数据
├── references/               # 售前判断知识库与流程参考
│   ├── 00-agent-os-framework.md
│   ├── 02-work-condition-schema.md
│   ├── 09-output-templates.md
│   ├── 17-quote-readiness.md
│   ├── 23-level-4-5-delivery-pack.md
│   └── 26-work-condition-rules.json
├── scripts/                  # 确定性护栏脚本
│   ├── classify_case_type.py
│   ├── check_context_completeness.py
│   ├── risk_tag_rules.py
│   ├── agent_os_governance.py
│   ├── presales_progression.py
│   ├── work_condition_rule_library.py
│   └── validate_output_pack.py
├── examples/                 # 典型售前输入和输出示例
├── bin/oneclear.js            # npm fallback CLI
├── lib/installer.js           # npm fallback 安装器
└── tests/                     # Node installer tests + Python guardrail tests

Development

npm test
python3 -c "import pathlib; print('Run Python tests with the local lightweight runner used in this repo')"
npm pack --dry-run

The npm package is a fallback installer. The primary distribution path is the GitHub skill repository:

npx skills add skip53/oneclear-skill

License

MIT License.