newtype Skill 体系实战(Super Analyst v1/v2 + Super Writer)

何时打开:你听说过 Claude Skills,想看一个"真实做出来、上 NPM、有 SKILL.md / references / scripts 三件套" 的完整范本。本 wiki 拆解 newtype(黄益贺)做的 3 个 Skill,它们都是 Anthropic Skill 格式的标准实现,最重要的是 Skill 是怎么编排"Sequential Thinking + 框架库 + MCP"的协同。

跟 newtype · MCP 协议与生态实战 的关系:那份讲 MCP 协议生态,本 wiki 讲 Skill 这一层抽象 —— Skill 调用 MCP,Skill 调用 Sequential Thinking,Skill 提供框架预设。

---

一、什么是 Skill(Anthropic 视角)

Skill = .skill 文件 = zip 包,含:

• SKILL.md(必有):Skill 的核心定义 + workflow
• references/(可选):详细文档(框架说明、用法示例、风格指南)
• scripts/(可选):Python / TypeScript 辅助脚本
• README.md / CHANGELOG.md / INSTALLATION-GUIDE.md(可选):用户文档

SKILL.md 的 frontmatter:

---
name: super-analyst
description: 简短描述 + 触发条件(LLM 自动识别何时调用此 Skill)
---

为什么是 Skill 而不是 MCP?

• MCP 是连接外部工具(GitHub / Notion / 数据库)
• Skill 是封装 Agent 行为模式(怎么思考、怎么搜索、怎么决策)
• Skill 可以调用 MCP,反过来不行

newtype 的判断(见 newtype · MCP 协议与生态实战):

"Skill 化是终态。任何提示词 + 工作流足够稳定,就 Skill 化。"

---

二、Skill #1:Super Analyst v1(2025-Q3)

2.1 核心定位

12 个分析框架的智能选择器。用户提问 → Skill 自动选最适合的框架(或组合) → 通过 MCP 取该框架的详细 prompt → 系统化执行。

2.2 SKILL.md 描述(frontmatter)

name: super-analyst
description: Advanced analytical framework selector for complex problem-solving 
  and decision-making. Use when users need structured analysis, strategic thinking,
  problem diagnosis, or decision support. Automatically selects and applies the 
  most appropriate framework(s) from 12 specialized analytical methods including 
  First Principles Thinking, 5 Whys, SWOT, Porter's Five Forces, Cost-Benefit 
  Analysis, Design Thinking, Systems Thinking, Socratic Method, Pareto Analysis, 
  MECE Principle, Hypothesis-Driven Analysis, and Scenario Planning.

2.3 12 个分析框架(完整对照表)

编号	框架	适用	何时用
1	First Principles Thinking	创新、突破性问题、复杂决策	需要根本重设计 / 多变量不确定 / 传统失效
2	5 Whys	故障诊断、流程改进	制造失败、软件 bug、客户投诉、重复错误
3	SWOT Analysis	商业战略、项目规划	评估竞争力、新业务、上市前风险
4	Porter's Five Forces	行业分析、竞争评估	市场进入决策、行业投资、并购、定价
5	Cost-Benefit Analysis	投资评估、政策决策	基础设施 / 技术升级、备选方案对比
6	Design Thinking	产品/服务创新、用户问题	开发 app / UX、教育健康挑战
7	Systems Thinking	复杂系统、宏观决策	看到整体相互作用
8	Socratic Method	探究本质、辩论	通过提问揭示假设
9	Pareto Analysis (80/20)	优先级、资源分配	80% 结果来自 20% 原因
10	MECE Principle	结构化分析(McKinsey)	全部覆盖、互斥
11	Hypothesis-Driven Analysis	科学方法	先假设再验证
12	Scenario Planning	不确定性、长期战略	多种未来情景

2.4 框架 prompt 通过 MCP 取(关键设计)

"Retrieves the detailed framework prompt using prompt-house-local MCP server"

• Skill 本身不存 12 个完整 prompt(那要几万字)
• Prompt 存在 prompt-house-local MCP 里
• Skill 工作流:分析需求 → 选框架 → MCP 取 prompt → 应用 → 输出

这是 newtype 的设计哲学:Skill 是 路由 + 选择 + 编排 层,具体内容(prompts)在 MCP 里(可独立维护、复用)。

2.5 references 文件

• references/framework-mapping.md:框架到适用场景的详细对照表
• references/usage-examples.md:每个框架的真实案例
• scripts/framework_selector.py:Python 辅助逻辑

---

三、Skill #2:Super Analyst Pro 2.0(2025-10-26)

3.1 核心升级(vs v1)

维度	v1	v2.0 (Pro)
行数	180	539(3x)
工作流	简单选择	7-Stage Systematic Workflow
思考	无	Dual Sequential Thinking(2 个 decision point)
信息	无	Web Search 集成(Chinese-English bilingual)
复杂度	一刀切	Level 1/2/3 自适应
输出	框架结果	Consulting-Grade Insights

口号:Deep Thinking + Comprehensive Research + Structured Analysis = Consulting-Grade Insights

3.2 7-Stage 工作流

Stage 1: Problem Understanding & Assessment        (10-30秒)
          ↓
Stage 2: Intelligence Planning (Sequential Thinking #1) *    [可跳]
          ↓
Stage 3: Intelligence Gathering                              [可跳]
          ↓
Stage 4: Framework Selection (Sequential Thinking #2) **     [必跑]
          ↓
Stage 5: Prompt Retrieval(via MCP)
          ↓
Stage 6: Structured Analysis
          ↓
Stage 7: Integrated Output

关键设计:

• Stage 4 是 always-execute 的核心 —— 任何复杂度都必须经过框架选择
• Stage 2-3 视信息需求决定是否跑(纯概念问题跳过)
• Sequential Thinking 用 两次(规划 + 决策)— 这是 newtype 的核心套路

3.3 Level 1/2/3 复杂度判定

Level	时间	描述	例子
Level 1 Simple	1-2 分钟	概念解释、框架描述	"What is SWOT analysis?"
Level 2 Medium	3-6 分钟	部分外部信息 + 2-3 维度	"Analyze Tesla's competitive advantages"
Level 3 Complex	10-20 分钟	深度研究 + 多维度战略	"Should we enter Indian market?"

3.4 信息需求 Trigger 表

✅ 需要外部信息(走 Stage 2-3):

• 具体公司/产品/市场/行业
• 当前数据(价格、排名、趋势)
• 案例、最佳实践、竞争情报
• 近期事件

❌ 不需要(跳到 Stage 4):

• 纯概念/理论
• 用户已提供完整 context
• 通用知识
• 框架说明

3.5 Sequential Thinking 在两个 Decision Point 的具体用法

Decision Point #1(Stage 2)— Intelligence Planning:

• 用 Sequential Thinking 拆"我需要哪些信息?去哪查?"
• 输出:Search Plan(4-6 个 search query)
• 中英文 bilingual 并行(国内信息搜中文、国际搜英文)

Decision Point #2(Stage 4)— Framework Selection:

• 用 Sequential Thinking 评估:用哪个/几个框架?顺序?权重?
• 输出:Framework Selection(1-3 个框架的执行计划)

3.6 包含文件清单

super-analyst-pro/
├── SKILL.md              539 行,主流程
├── README.md             用户文档,Quick Start
├── INSTALLATION-GUIDE.md 安装步骤
├── CHANGELOG.md          v1 → v2.0 升级日志
├── UPGRADE-SUMMARY.md    升级亮点
└── references/
    ├── framework-mapping.md
    ├── search-strategy-guide.md
    └── sequential-thinking-prompts.md

对比 v1:v2.0 是真正的"产品",有完整产品文档。v1 是"原型"。

---

四、Skill #3:Super Writer(2025-10-27)

4.1 核心定位

专业内容创作助手,3 大能力:

1. 📚 Material Collection — 智能 web 搜索 + 用户素材整理
2. 🎨 Style Analysis — 7 种风格分析方法,从参考内容提炼写作风格
3. ✍️ Content Writing — 6 种proven 写作方法论

4.2 触发条件(LLM 自动识别)

"Triggers when users need to create articles, marketing copy, stories, reports, social media posts, emails, blogs, or any text-based content creation tasks."

4.3 关键设计:Triple Sequential Thinking

Stage 2: Material Planning(Sequential Thinking #1)
Stage 4.5: Style Analysis Planning(Sequential Thinking #2)
Stage 6: Methodology Selection(Sequential Thinking #3)

super-analyst 是 dual(双 Sequential Thinking),super-writer 是 triple —— 更复杂任务需要更多 thinking 决策点。

4.4 7-Stage 工作流

Stage 1: Content Request Analysis
   ↓
Stage 2: Material Planning(Sequential Thinking #1)*
   ↓
Stage 3: Material Collection
   ↓
Stage 4: Style Reference Check **
   ↓ [if reference]
Stage 4.5: Style Analysis Planning(Sequential Thinking #2)
   ↓
Stage 5: Style Analysis Execution
   ↓
Stage 6: Methodology Selection(Sequential Thinking #3)
   ↓
Stage 7: Content Writing + Output

4.5 7 种 Style Analysis 方法

(从 references/style-analysis-guide.md)

1. Structural Analysis — 段落组织、开篇/结尾模式
2. Tone Analysis — formal / casual / authoritative / conversational
3. Vocabulary Profile — 高频词、句长分布、专业术语密度
4. Rhythm & Pacing — 短长句交替、节奏 patterns
5. Voice Analysis — first / second / third person 偏好
6. Persuasion Patterns — 论证方法、情感曲线
7. Cultural Markers — 文化指涉、典故、当地语境

4.6 6 种 Writing Methodology

(从 references/methodology-mapping.md)

Methodology	适用
AIDA(Attention-Interest-Desire-Action)	营销文案
PAS(Problem-Agitation-Solution)	销售页
Pyramid Principle	报告/分析
Inverted Pyramid	新闻
Hero's Journey	故事
Story Spine	短叙事

4.7 关键 Format Rules(SKILL.md 警告)

🚨 CRITICAL: NEVER display in user-facing output:
  ❌ HTML tags like <details>, <summary>
  ❌ Raw tool call syntax
  ❌ Sequential Thinking tool output (process is internal)

✅ ALWAYS use clean Markdown
✅ Users see ONLY the RESULT of thinking, not the process

这反映 newtype 的工程化判断:Sequential Thinking 是 Agent 内部状态,不应暴露给用户。

---

五、3 个 Skill 的共同模式(高级 Pattern)

5.1 Skill 设计的 5 大共性

1. Sequential Thinking 是核心 —— 不是直接 generate,是先 think 再 act
2. MCP 取大块内容(prompts / templates) —— Skill 本身轻量,内容外置
3. 7-Stage 工作流 —— 都是 7 步,先理解 → 规划 → 收集 → 决策 → 执行 → 整合 → 输出
4. 复杂度自适应(Level 1/2/3)—— 不要小题大做
5. 完整产品化(README + CHANGELOG + Installation guide)

5.2 Skill 的 "router + executor" 哲学

User Request
   ↓
Skill 作为 "router"(路由器)
   ↓
分析 → 选最优 framework / methodology / strategy
   ↓
MCP / Sub-tool 作为 "executor"(执行器)
   ↓
取详细 prompt → 实际生成

Skill 不解决具体问题,Skill 解决"该用哪个方法"的元问题。

5.3 触发条件设计

3 个 Skill 都通过 SKILL.md frontmatter 的 description 触发:

• 越具体越好(列出 12 个框架名、7 种风格方法)
• 包含 use case 关键词(LLM 自动 match)
• 包含 trigger 句("Triggers when users need to...")

---

六、对独立开发者的启示

6.1 何时该做 Skill(而不是 MCP / Workflow)

你的需求	推荐
调外部 API / 工具(GitHub / Slack / DB)	MCP
想固化"分析方法论 / 写作方法论 / SOP"	Skill
想做一个完整的多步骤业务流程	Workflow(n8n / Dify)
想编排"先想 → 再搜 → 再决策 → 再执行"	Skill + Sequential Thinking

6.2 Skill 工程化的 6 条建议(从 3 个范本)

1. frontmatter 写仔细:LLM 靠这个决定要不要触发
2. 7-Stage 是 sweet spot:再少不严谨,再多用户/LLM 都跟不上
3. Sequential Thinking 用 2-3 次:在关键 decision point,不是每步
4. 大 prompt 别塞 SKILL.md:放 references/ 或 MCP
5. 写 CHANGELOG:v1 → v2 升级清晰
6. 隐藏内部状态:Sequential Thinking 的输出不给用户看

6.3 怎么把 newtype 的 Skill 部署到自己 Claude

# 把 .skill 文件放到 Claude 的 skills 目录
~/.claude/skills/super-analyst.skill

# Claude 重启后,自动加载
# 通过 Slash command 显式调用或自然语言触发

newtype 在 newtype · MCP 协议与生态实战 中的判断已应验:

"Skill 化是终态。一旦做出来,可以反复用、跨 session 用、给团队用。"

---

七、跟其他 wiki 的连接

• newtype · MCP 协议与生态实战 — MCP 协议生态(Skill 的工具层)
• newtype · Prompt / Context Engineering 实战 — Prompt 工程(Skill 的 prompt 层)
• Claude Code 最佳实践(Cal Rueb · Anthropic 内部讲座) — Cal Anthropic 视角的 Claude Code(本 wiki 是 newtype 自建 Skill 范本)
• newtype · Vibe Coding 独立产品实战 — newtype 的独立开发产品史(Super Analyst / Super Writer 是其中产品)
• newtype 知识系统与 Life OS 全演化 — newtype OS 知识系统(Skill 是 OS 的 "应用程序"层)
• 王凯多 Agent 浏览器矩阵架构(v1.1 实操指南) — 王凯多浏览器 Agent 矩阵(他的 Skill 体系跟 newtype 不同范式)

---

History

• 2026-05-17:Phase 5.1 ingest 从 file_023(Super Analyst v1.skill)+ file_024(Super Analyst Pro 2.0.skill)+ file_025(Super Writer zip)三个 zip 包提取,合并写 1 个 wiki。完整覆盖 3 个 Skill 的 SKILL.md / references / scripts / README / CHANGELOG。

来源与关联资料

• newtype · MCP 协议与生态实战
• newtype · Prompt / Context Engineering 实战
• Claude Code 最佳实践(Cal Rueb · Anthropic 内部讲座)
• newtype · Vibe Coding 独立产品实战
• newtype 知识系统与 Life OS 全演化