本文へ移動
cccskills
無料GitHub で公開

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驱动决策、用户行为不可预测、概率性输出等话题时也应触发。

インストール方法を見る

含まれるファイル(6)

  • SKILL.md10.9 KB
  • evals/routing-evals.json1.8 KB
  • references/behavioral-clusters.md3.4 KB
  • references/drift-detection.md4.4 KB
  • references/model-routing.md1.1 KB
  • references/operating-playbook.md2.1 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

雪峰方法论:AI-Native 产品开发实战体系

核心理念:强模型依赖 × 多专精Agent × 快速校准 × 行为审计

来源:雪峰——AI-Native连续创业者,深耕AI日历管理等AI驱动产品。 核心洞察:穷举是死循环,唯快不破才是AI-native的生存之道。

与克谦方法论(keqian-method)互为对偶: 克谦解决"如何让AI在明确边界内可靠执行", 雪峰解决"当边界本身不确定时怎么办"。


第零步:产品类型判断(必须先做)

在选择任何开发策略之前,先判断你的产品类型。 选错方法论比没有方法论更危险。

类型特征关键判断标准推荐方法
+AI(场景依赖型)用户行为可枚举,AI辅助执行确定性流程能列出所有合法输入输出组合→ keqian-method
AI-native(强模型依赖型)AI驱动核心决策,用户行为开放式用户的下一步操作你无法预测→ 本skill
混合型核心流程确定,部分环节AI-native能拆分出哪些模块是确定的、哪些是开放的→ 两者结合,按模块选用

快速判断清单

回答以下问题,如果3个以上答"是",你大概率是AI-native:

  1. 用户的输入是自由文本/语音,而非选择菜单?
  2. 同一输入,你希望AI给出不同风格的输出?
  3. 用户会因为AI的回答方式而改变自己的后续行为?
  4. 你无法为产品写出完整的功能测试用例集?
  5. 产品的核心价值在于AI的"判断"而非"执行"?

第一原则:穷举是死循环

"穷举意味着:有多少人工,就有多少智能。这是死循环。"

为什么在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架构

               ┌─ 理解Agent(NLU:解析用户意图)
               │
用户输入 → 路由器 ─┼─ 执行Agent(Action:调用API/修改数据)
               │
               ├─ 校验Agent(Verify:检查执行结果)
               │
               └─ 表达Agent(NLG:生成用户可见回复)

每只虾只干一种活的好处:

  • 出bug时,能精确定位是哪只虾的问题
  • 单独升级/替换某只虾,不影响其他
  • 每只虾可以用最适合它的模型(路由策略)

拆分决策矩阵

条件拆分?原因
功能正交,输出互不依赖✅并行执行,互不干扰
各自有独立的验证标准✅单独eval,精确定位
失败时只影响局部✅局部重试,不整体报废
有上下文依赖链❌合并时容易出不一致
你无法精确控制上下文注入❌注入什么、多少都要精确控制
合并结果需要复杂对齐❌合并成本可能超过收益

与克谦方法的差异

维度克谦(单agent极致)雪峰(多专精agent)
默认选择顺序执行并行分工
适用场景有依赖链的长程任务功能正交的独立模块
出错定位在长链中回溯直接定位出错的虾
风险链越长概率乘越低合并时可能不一致

不是对错,是产品类型不同。 同一产品内也可以混用。


第三原则:唯快不破

"无法预知上线后用户反馈和喜好,只能唯快不破。"

AI-Native快速迭代循环

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 == expectedcheck output ∈ acceptable_set
失败处理自动修复 → 升级人工分析漂移原因 → 调整策略
质量指标缓存命中率用户满意度 + 模型一致性
迭代触发门禁不通过用户反馈 + 漂移检测
成本模型高缓存命中 = 低成本路由到合适模型 = 可控成本

行为审计实施

定期(每日/每周)
├── 采样模型输出(N=100+)
├── 自动检查行为属性(格式、安全、一致性)
├── 人工抽检(关键决策质量)
├── 漂移检测(输出分布与基线对比)
└── 生成审计报告 → 决定是否触发校准

漂移检测信号

以下信号出现时,说明模型可能在漂移:

  1. 输出分布偏移:同类输入的输出风格/长度/结构发生变化
  2. 用户投诉增加:满意度指标下降
  3. 异常行为增多:超时、拒答、幻觉增加
  4. 上下游不一致:Agent间的输出格式或语义不对齐

第六原则:一切以用户为中心

"AI-native的代价很大,就是一切以用户为中心。" "用户一旦用惯了AI-native,就再也回不到传统模式了。"

用户适应性飞轮

用户使用AI-native产品
  → 用户期望提高(不接受传统交互)
  → 产品必须持续进化
  → 需要更强的模型 / 更好的校准
  → 用户体验提升
  → 用户期望进一步提高
  → …(正向循环,但也是成本螺旋)

管理用户期望

  • 不要过度承诺:AI-native不是万能的,明确能力边界
  • 设计优雅降级:AI不确定时给用户选择权,而非强行给答案
  • 透明度:让用户知道AI在做什么,建立信任
  • 反馈闭环:让用户的反馈真正影响产品迭代

验收标准(按本方法论执行的任务,交付前自查)

  • 第零步已做:产品类型判断(+AI / AI-native / 混合)有明确结论并据此选了方法
  • Agent 分工遵循"每只虾只干一种活",每个 Agent 的职责一句话说得清
  • 上线/交付带行为审计方案:知道怎么发现模型行为漂移,而不是等用户投诉
  • 没有为追求"校准到 95%"而无限延期——快速上线 + 快速校准的节奏有体现
  • 模型选择有路由依据(成本/能力/延迟),不是全用最贵的

实战与协作模板

实战工作流、日常运维节奏、与 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 校验

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

A股分析研究助手,提供行情数据获取与技术面/基本面分析框架(仅供研究参考,不构成投资建议)。适用于:(1) 获取A股行情和历史数据,(2) 技术面分析(K线形态、MACD、KDJ、RSI、布林带等),(3) 基本面分析(财务指标、估值分析),(4) 板块热点追踪,(5) 选股策略筛选与量化因子分析,(6) 生成股市分析报告。当用户询问"帮我分析股票"、"今日选股"、"A股行情分析"、"技术分析"、"量化选股"时触发。不用于:预测明日涨跌或给出确定性买卖指令、代客决策、港股美股(数据源不同)、加密货币。

日本語の概要は準備中です。原文の説明を表示しています。

staruhub/ClaudeSkills7282026年8月13日 更新

AI咨询/销售的对话策略助手。当用户需要准备AI方案沟通、跟业务部门聊AI落地、写AI提案、应对客户异议、做AI培训破冰时使用。触发场景:"怎么跟老板聊AI"、"客户说AI不靠谱"、"准备一个AI方案汇报"、"帮我想想怎么推AI"、"业务部门不配合"、"AI项目怎么卖"、"demo之后怎么跟进"。也适用于AI咨询师、技术合伙人、CTO做内部AI推广。

日本語の概要は準備中です。原文の説明を表示しています。

staruhub/ClaudeSkills7282026年8月13日 更新

Windows C盘清理和磁盘空间管理。当用户说C盘满了、磁盘空间不足、清理临时文件/缓存/回收站/系统日志、查找大文件、分析磁盘占用时使用。仅适用于 Windows 环境。不用于:macOS/Linux 磁盘清理、卸载软件(引导用户走系统卸载)、清理用户个人文件(只报告位置,删除决定权在用户)。

日本語の概要は準備中です。原文の説明を表示しています。

staruhub/ClaudeSkills7282026年8月13日 更新

PPT 生产 Agent:理解场景 → 推荐风格 → 先出大纲 → 定义页面 → 双通路交付(PPT 内容稿 / 逐页视觉图 / 信息图组图)。当用户要做汇报、路演、培训课件、提案、咨询报告的演示文稿,或要把大纲/文章做成 slides、deck、PPT、信息图、小红书图文、可视化传播图时使用。支持指定风格或从风格库推荐,支持 image 模型逐页出视觉稿。前身为 notion-infographic(v2)并吸收 ppt-designer 的设计原则。不用于:pptx 文件的纯技术操作(拆分/合并/提取,用宿主 pptx skill)、演讲稿或文章本体的写作(用 wechat-article-writer)、需要先做研究的内容调研(先走 deep-research 再回来)、单张海报或 logo 设计。

日本語の概要は準備中です。原文の説明を表示しています。

staruhub/ClaudeSkills7282026年8月13日 更新

Use this skill when the user wants an evidence-based research memo, literature review, market/policy/technical landscape, or a multi-source decision brief with citations, trade-offs, and a clear conclusion. Best for tasks that need synthesis across multiple external sources, iterative follow-up research, or a reusable written artifact. Do not use for quick factual lookups, single-source summaries, simple Q&A, summarizing one document the user already provided, plan-only requests where the user explicitly defers the actual research, or when the user wants a short answer with no need for cited evidence (a short but evidence-backed conclusion is still a brief memo, which this skill covers). Chinese trigger examples: "帮我调研", "深度研究", "综述报告", "技术选型分析", "竞品研究", "政策分析".

日本語の概要は準備中です。原文の説明を表示しています。

staruhub/ClaudeSkills7282026年8月13日 更新

资深高考命题专家助手,提供专业的命题指导和评审服务。适用于创作高考试题、评审试题质量、分析试卷结构、了解命题趋势等场景。结合文档工具提取解压文件,使用网络搜索了解当年最新命题趋势,使用分析工具评估题目质量和试卷结构。涵盖"一核四层四翼"评价体系、题型规范、评分标准、命题流程等多个维度。不用于:大学/考研/中考命题(体系不同,仅可借鉴)、日常作业题编写、直接替考生解题。

日本語の概要は準備中です。原文の説明を表示しています。

staruhub/ClaudeSkills7282026年8月13日 更新

staruhub のスキルをすべて見る

このスキルの問題を報告する