staruhub/xuefeng-method
雪峰式AI-Native产品开发方法论。适用于:(1) 用户行为开放、不可穷举的AI-native产品(AI日历、AI助手、AI推荐、对话式产品等),(2) 强模型依赖型场景,AI驱动核心决策而非仅辅助,(3) 多专精Agent架构设计与分工,(4) 上线后快速校准、行为审计与漂移检测,(5) 模型选择和智能路由策略,(6) 概率性输出的质量评估。触发场景包括"AI-native产品怎么做"、"用户行为不可预测怎么办"、"多agent怎么分工"、"模型漂移怎么处理"、"校准到95%太难了"、"唯快不破"、"怎么选模型"、"agent并行分工"、"AI产品上线后怎么迭代"。注意:如果产品是场景明确、边界可定义的+AI类型,请改用 keqian-method skill。即使用户没有明确说"AI-native",但在讨论AI驱动决策、用户行为不可预测、概率性输出等话题时也应触发。
npx skills add https://github.com/staruhub/ClaudeSkills --skill xuefeng-method
> 核心理念:强模型依赖 × 多专精Agent × 快速校准 × 行为审计
>
> 来源:雪峰——AI-Native连续创业者,深耕AI日历管理等AI驱动产品。
> 核心洞察:穷举是死循环,唯快不破才是AI-native的生存之道。
>
> 与克谦方法论(keqian-method)互为对偶:
> 克谦解决"如何让AI在明确边界内可靠执行",
> 雪峰解决"当边界本身不确定时怎么办"。
在选择任何开发策略之前,先判断你的产品类型。
选错方法论比没有方法论更危险。
| 类型 | 特征 | 关键判断标准 | 推荐方法 |
|------|------|------------|---------|
| +AI(场景依赖型) | 用户行为可枚举,AI辅助执行确定性流程 | 能列出所有合法输入输出组合 | → keqian-method |
| AI-native(强模型依赖型) | AI驱动核心决策,用户行为开放式 | 用户的下一步操作你无法预测 | → 本skill |
| 混合型 | 核心流程确定,部分环节AI-native | 能拆分出哪些模块是确定的、哪些是开放的 | → 两者结合,按模块选用 |
回答以下问题,如果3个以上答"是",你大概率是AI-native:
> "穷举意味着:有多少人工,就有多少智能。这是死循环。"
在+AI场景下,克谦说"边界内可穷举,单维度选项有限"——这是对的。
但AI-native场景的数学不一样:
用户行为空间(开放) × 模型输出空间(概率性) × 上下文状态(动态)
= 组合爆炸,不可穷举
一个日历管理能有多复杂?答案是:走AI-native路线后,非常复杂。
因为用户一旦习惯AI-native交互,就永远回不到传统模式——
你必须持续适应用户不断演化的期望。
策略1:行为模式簇(Behavioral Clusters)
不枚举每个case,而是聚类用户行为模式:
原始行为空间(不可穷举)
↓ 聚类
行为模式簇(5-15个典型模式)
↓ 每个模式簇
设计对应的AI响应策略
↓ 边界case
优雅降级到确定性逻辑
策略2:优雅降级(Graceful Degradation)
AI不确定时,回退到确定性逻辑:
AI置信度 > 阈值 → AI决策(快路径)
AI置信度 < 阈值 → 确定性回退(安全路径)
AI置信度极低 → 请求人工介入(慢路径)
策略3:概率性验收(Probabilistic Acceptance)
不用 assert output == expected,而用 check output ∈ acceptable_set:
# 传统断言式(克谦适用)
assert response == "会议安排在下午3点"
# 行为属性式(雪峰适用)
assert "下午" in response
assert contains_time(response)
assert tone_is_professional(response)
assert no_hallucinated_contacts(response)
> "多养两只虾,每只都比较专业,只干一种活。出了问题找bug容易。
> 一个全面能干的虾,出了问题找问题非常麻烦。"
┌─ 理解Agent(NLU:解析用户意图)
│
用户输入 → 路由器 ─┼─ 执行Agent(Action:调用API/修改数据)
│
├─ 校验Agent(Verify:检查执行结果)
│
└─ 表达Agent(NLG:生成用户可见回复)
每只虾只干一种活的好处:
| 条件 | 拆分? | 原因 |
|------|:------:|------|
| 功能正交,输出互不依赖 | ✅ | 并行执行,互不干扰 |
| 各自有独立的验证标准 | ✅ | 单独eval,精确定位 |
| 失败时只影响局部 | ✅ | 局部重试,不整体报废 |
| 有上下文依赖链 | ❌ | 合并时容易出不一致 |
| 你无法精确控制上下文注入 | ❌ | 注入什么、多少都要精确控制 |
| 合并结果需要复杂对齐 | ❌ | 合并成本可能超过收益 |
| 维度 | 克谦(单agent极致) | 雪峰(多专精agent) |
|------|-------------------|-------------------|
| 默认选择 | 顺序执行 | 并行分工 |
| 适用场景 | 有依赖链的长程任务 | 功能正交的独立模块 |
| 出错定位 | 在长链中回溯 | 直接定位出错的虾 |
| 风险 | 链越长概率乘越低 | 合并时可能不一致 |
不是对错,是产品类型不同。 同一产品内也可以混用。
> "无法预知上线后用户反馈和喜好,只能唯快不破。"
Phase 1: 行为属性测试(上线前)
├── 不是断言式测试,是属性检查
├── "输出合理吗?" 而非 "输出等于X吗?"
└── 通过 = 可以上线,不通过 = 还不够稳
Phase 2: 快速上线(MVP心态)
├── 不追求完美,追求"可接受"
├── 95%校准极难,先追求80%
└── 剩下的靠用户反馈补
Phase 3: 用户反馈 + 漂移检测
├── 收集:用户满意度、异常行为、投诉
├── 检测:模型输出分布是否偏移
└── 预警:漂移超过阈值 → 触发校准
Phase 4: 快速校准
├── 提示词迭代(最快)
├── 模型切换/升级(中等)
├── 微调/RLHF(最慢但最持久)
└── 下一轮上线 → 回到Phase 3
| 策略 | 单次质量 | 迭代速度 | AI-native适用性 |
|------|---------|---------|---------------|
| 一次做到95% | 极高 | 极慢 | ❌ 不现实 |
| 先80%上线再迭代 | 中等 | 快 | ✅ 推荐 |
| 60%就上 | 低 | 极快 | ⚠️ 风险大,慎用 |
> "如果不是纯coding,尽量不要用xxx-codex模型,直接切通用模型就行了。"
> "慢点就慢点,但牢靠,不啰嗦。"
模型路由决策树、dumb zone 防护和多模型协作细节见 references/model-routing.md。
> 克谦用严格门禁 → 缓存命中飞轮。这在确定性输出场景有效。
> AI-native输出是概率性的,需要不同的质量策略。
| 维度 | 克谦门禁(确定性) | 雪峰审计(概率性) |
|------|-------------------|-------------------|
| 测试方式 | assert output == expected | check output ∈ acceptable_set |
| 失败处理 | 自动修复 → 升级人工 | 分析漂移原因 → 调整策略 |
| 质量指标 | 缓存命中率 | 用户满意度 + 模型一致性 |
| 迭代触发 | 门禁不通过 | 用户反馈 + 漂移检测 |
| 成本模型 | 高缓存命中 = 低成本 | 路由到合适模型 = 可控成本 |
定期(每日/每周)
├── 采样模型输出(N=100+)
├── 自动检查行为属性(格式、安全、一致性)
├── 人工抽检(关键决策质量)
├── 漂移检测(输出分布与基线对比)
└── 生成审计报告 → 决定是否触发校准
以下信号出现时,说明模型可能在漂移:
> "AI-native的代价很大,就是一切以用户为中心。"
> "用户一旦用惯了AI-native,就再也回不到传统模式了。"
用户使用AI-native产品
→ 用户期望提高(不接受传统交互)
→ 产品必须持续进化
→ 需要更强的模型 / 更好的校准
→ 用户体验提升
→ 用户期望进一步提高
→ …(正向循环,但也是成本螺旋)
实战工作流、日常运维节奏、与 keqian-method 的互补关系,以及心法总结已集中到 references/operating-playbook.md。入口文件只保留判断、原则和导航,避免主文档继续膨胀。
更多细节请查阅:
references/behavioral-clusters.md — 行为模式簇设计方法references/drift-detection.md — 模型漂移检测与校准协议references/model-routing.md — 模型选择、上下文阈值和智能路由references/operating-playbook.md — 实战工作流、运维节奏和方法论互补关系evals/routing-evals.json — 触发边界回归用例(含与 keqian-method 的互斥镜像),改动 description 后用仓库根 scripts/run_routing_evals.py 校验Take staruhub/xuefeng-method from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.