Doramagic 项目包 · 项目说明书
strategy-skills 项目
生成时间:2026-05-31 17:23:21 UTC
项目介绍
Strategy Skills 是 Eterdis 推出的开源战略框架集合,旨在将大型语言模型(LLM)转化为战略思维伙伴。这些技能以结构化 Markdown 格式呈现,通过引导式对话帮助用户进行战略分析和决策制定。 资料来源:[README.md:1-7]()
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
项目概述
Strategy Skills 是 Eterdis 推出的开源战略框架集合,旨在将大型语言模型(LLM)转化为战略思维伙伴。这些技能以结构化 Markdown 格式呈现,通过引导式对话帮助用户进行战略分析和决策制定。 资料来源:README.md:1-7
项目基于 20 年咨询实践经验开发,完全免费、开源且模型无关。支持 Claude、ChatGPT、Gemini 或任何支持读取 Markdown 的模型运行。 资料来源:README.md:8-11
核心设计理念
共享上下文机制
所有技能共享一个 company-context.md 文件,该文件在每次会话后更新,逐步积累战略情报。 资料来源:README.md:21-22
graph LR
A[用户会话] --> B[读取 company-context.md]
B --> C[运行战略技能]
C --> D[更新 company-context.md]
D --> A三种运行模式
| 模式 | 用途 | 预计时长 |
|---|---|---|
| Diagnostic(诊断) | 深度首次使用会话 | 30-60 分钟 |
| Review(回顾) | 定期重新评估 | 15-20 分钟 |
| Alert Triggers(预警触发) | 监控会话间的早期预警信号 | 按需 |
资料来源:README.md:16-19
技能体系
理解当前位置
| 技能名称 | 功能描述 |
|---|---|
| strategy-diagnostic | 入口点——AI 引导的战略评估,检测应运行哪些框架 |
| strategy-map | 从资源到结果的因果链映射 |
| vrio-analysis | 测试竞争优势是否真实、稀有且持久 |
| environmental-radar | 持续 PESTEL 扫描外部力量 |
| market-position | 竞争定位——你实际所处的位置 |
| wardley-map | 价值链与演化轴心映射 |
| first-principles | 第一性原理思维框架 |
| pre-mortem | 事前验尸分析 |
| protoloop-setup | 原型循环与内部创业机制 |
资料来源:README.md:23-38
架构组件
技能文件结构
每个技能目录下包含核心文件:
graph TD
A[skill-name/SKILL.md] --> B[技能主文件]
A --> C[install/skills/xxx.md]
C --> D[安装版技能文件]
B --> E[诊断模式]
B --> F[回顾模式]
B --> G[预警触发模式]核心数据结构
company-context.md 作为共享上下文文件,包含以下结构化区域: 资料来源:install/company-context.md:1-60
| 区域 | 描述 | 更新频率 |
|---|---|---|
| Organisation | 组织基本信息 | 按需 |
| What pays the bills | 当前业务描述 | 按需 |
| Resources that matter | 核心资源与能力(VRIO分析) | 定期验证 |
| Customers | 客户群体与购买动机 | 定期更新 |
| Competitive landscape | 竞争格局 | 定期审查 |
| Current strategy | 当前战略 | 按需 |
技能运行流程
战略诊断流程
strategy-diagnostic 作为主入口技能,采用以下结构化流程: 资料来源:strategy-diagnostic/SKILL.md:40-80
graph TD
A[Phase 1: Landscape<br/>理解现状] --> B[Phase 2: Framework<br/>选择框架]
B --> C[Phase 3: Synthesis<br/>综合分析]
C --> D[输出关键发现]
D --> E[确认遗漏项]第一性原理分析
first-principles-strategy 专注于区分物理约束与常规约束: 资料来源:first-principles-strategy/SKILL.md:20-35
| 约束类型 | 定义 | 示例 |
|---|---|---|
| 物理约束 | 宇宙不允许违反的规律 | 光速、热力学 |
| 常规约束 | 习惯、"历来做法" | 内部流程、假设前提 |
Wardley 映射
wardley-map 技能实现双轴分析框架: 资料来源:wardley-map/SKILL.md:15-45
- 纵轴:价值链——从用户需求到基础设施的依赖关系
- 横轴:演化轴——从 Genesis → Custom-built → Product → Commodity 的演进
graph LR
A[Genesis<br/>创世] --> B[Custom-built<br/>定制]
B --> C[Product<br/>产品]
C --> D[Commodity<br/>商品化]VRIO 分析框架
vrio-analysis 基于 Jay Barney 1991 年提出的 VRIO 框架,对资源进行四问审查: 资料来源:vrio-analysis/SKILL.md:25-35
| 问题 | 含义 |
|---|---|
| Valuable(有价值) | 资源是否能利用机会或抵御威胁? |
| Rare(稀有) | 多少竞争对手拥有此资源? |
| Imitable(难以模仿) | 复制该资源的成本有多高? |
| Organization(组织) | 企业是否准备好开发利用此资源? |
预 Mortem 分析
pre-mortem 采用事前验尸方法,在计划实施前识别潜在失败模式: 资料来源:pre-mortem/SKILL.md:15-30
graph TD
A[设定模式] --> B{存在预Mortem发现?}
B -->|是| C[回顾模式]
B -->|否| D[诊断模式]
C --> E[检查失败模式演变]
D --> F[Setup: 获取计划]
F --> G[识别假设]
G --> H[预测失败模式]
H --> I[设计缓解措施]原型循环机制
protoloop-setup 旨在保护 Track Two(探索性工作)与 Track One(核心业务)的资源隔离: 资料来源:protoloop-setup/SKILL.md:10-35
| 追踪轨道 | 描述 | 优先级 |
|---|---|---|
| Track One | 核心业务执行 | 始终优先 |
| Track Two | 内部创业与探索性实验 | 需专门保护 |
安装与部署
目录结构
strategy-skills/
├── README.md
├── SKILL-TEMPLATE.md
├── strategy-diagnostic/
│ └── SKILL.md
├── strategy-map/
│ └── SKILL.md
├── vrio-analysis/
│ └── SKILL.md
├── environmental-radar/
│ └── SKILL.md
├── market-position/
│ └── SKILL.md
├── wardley-map/
│ └── SKILL.md
├── first-principles-strategy/
│ └── SKILL.md
├── pre-mortem/
│ └── SKILL.md
├── protoloop-setup/
│ └── SKILL.md
└── install/
├── company-context.md
├── STRATEGY.md
└── skills/
├── *.md
└── mcp-server/
MCP 服务器
项目包含 @eterdis/strategy-skills-mcp MCP 服务器,提供模型上下文协议支持: 资料来源:mcp-server/package.json:1-20
{
"name": "@eterdis/strategy-skills-mcp",
"version": "1.0.0",
"dependencies": {
"@modelcontextprotocol/sdk": "^1.29.0",
"zod": "^3.25.0"
}
}
使用指南
首次使用流程
- 阅读
company-context.md文件了解现有上下文 - 选择合适的入口技能(推荐
strategy-diagnostic) - 根据提示选择运行模式(诊断/回顾/预警)
- 完成会话后,技能会自动更新
company-context.md - 在后续会话中引用更新后的上下文
上下文更新机制
每个技能在完成诊断后都会更新 company-context.md,包括: 资料来源:protoloop-setup/SKILL.md:50-75
- 关键发现记录
- 开放性问题追踪
- 行动项与时间表
- 下次审查日期
会话日志格式
| 日期 | 运行技能 | 关键发现 | 采取行动 | 下次审查 |
|---|---|---|---|---|
| YYYY-MM-DD | 技能名称 | 发现摘要 | 决定事项 | 审查日期 |
技术特性
模型无关性
项目设计不依赖特定 LLM 提供商,通过标准 Markdown 格式实现跨平台兼容: 资料来源:README.md:8-10
- Claude
- ChatGPT
- Gemini
- 其他支持 Markdown 的模型
框架兼容性
技能可独立运行,也可组合使用以形成完整的战略分析流程。
扩展机制
通过 SKILL-TEMPLATE.md 模板可以创建自定义技能: 资料来源:SKILL-TEMPLATE.md:1-80
许可与贡献
项目采用开源模式,详细信息请参阅项目根目录 LICENSE 文件。
资料来源:README.md:16-19
快速开始
本文档为 eterdis/strategy-skills 项目的新用户提供全面的入门指南,帮助您快速了解、安装并开始使用策略技能框架。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
项目概述
什么是策略技能
策略技能(Strategy Skills)是一套结构化提示模板,采用 SKILL.md 格式,用于引导大语言模型(LLM)执行经过验证的战略框架。这些技能帮助 LLM 提出正确的问题、发现模式、揭示矛盾并产出可操作的输出。
graph TD
A[用户/分析师] --> B[策略技能 SKILL.md]
B --> C[LLM 推理引擎]
C --> D[结构化对话]
D --> E[可操作输出]
F[Claude] --> C
G[ChatGPT] --> C
H[Gemini] --> C核心特性
| 特性 | 描述 |
|---|---|
| 模型无关 | 支持 Claude、ChatGPT、Gemini 或任何支持 Markdown 的 LLM |
| 三种运行模式 | Diagnostic(诊断)、Review(回顾)、Alert Triggers(预警触发器) |
| 上下文共享 | 所有技能读取并更新共享的 company-context.md 文件 |
| 咨询经验驱动 | 基于 20 年咨询实践构建 |
安装方式
方式一:使用 install 目录
项目提供了完整的安装包,位于 install/ 目录,包含所有技能的预配置版本:
install/
├── company-context.md # 公司上下文模板
├── STRATEGY.md # 策略主文件
└── skills/ # 技能子目录
├── first-principles.md
├── pre-mortem.md
├── protoloop.md
├── vrio.md
└── wardley-map.md
方式二:使用 MCP 服务器
对于需要程序化访问的场景,项目提供了 MCP(Model Context Protocol)服务器实现,位于 mcp-server/ 目录:
// mcp-server/package.json 核心依赖
{
"@modelcontextprotocol/sdk": "^1.29.0",
"zod": "^3.25.0"
}
核心概念
三种运行模式
策略技能支持三种不同的运行模式,适用于不同的使用场景:
| 模式 | 适用场景 | 预计时长 | 说明 |
|---|---|---|---|
| Diagnostic | 首次使用或重大变更后 | 30-60 分钟 | 完整的深度会话 |
| Review | 定期重新评估 | 15-20 分钟 | 检查发现是否仍然有效 |
| Alert Triggers | 设置预警信号 | 10-15 分钟 | 定义需要监控的触发条件 |
共享上下文机制
所有策略技能都依赖 company-context.md 文件来维护跨会话的战略情报:
graph LR
A[Session 1] -->|更新| C[company-context.md]
B[Session 2] -->|读取| C
B -->|更新| C
D[Session N] -->|读取| C
D -->|更新| C公司上下文文件
文件结构
company-context.md 是项目的核心数据文件,包含以下关键部分:
| 章节 | 内容 | 更新频率 |
|---|---|---|
| Organisation | 组织基本信息(名称、行业、规模等) | 首次/重大变更时 |
| What pays the bills | 当前业务描述 | 季度回顾 |
| Resources that matter | 3-5 种核心资源/能力 | VRIO 分析时 |
| Customers | 真实客户信息 | 半年回顾 |
| Competitive landscape | 竞争格局分析 | 季度更新 |
| Current strategy | 当前策略(一段式描述) | 年度审视 |
VRIO 资源表结构
| Resource | Type | VRIO status | Last validated |
|----------|------|-------------|----------------|
| [资源名] | [类型] | [状态] | [日期] |
竞争格局表结构
| Competitor | Their advantage | Your advantage vs. them | Threat level | Last reviewed |
|------------|-----------------|------------------------|--------------|----------------|
| [竞争对手] | [他们的优势] | [你的优势] | [威胁等级] | [日期] |
可用技能一览
理解当前位置
| 技能名称 | 功能描述 |
|---|---|
strategy-diagnostic | 入口点——AI 引导的战略评估,检测应运行哪些框架 |
strategy-map | 映射从资源到结果的因果链 |
vrio-analysis | 测试竞争优势是否真实、稀有且持久 |
environmental-radar | 持续 PESTEL 扫描,识别外部力量 |
market-position | 竞争定位——你实际的位置,非幻灯片上的位置 |
wardley-map | Wardley 映射——业务格局的双轴地图 |
其他高级技能
| 技能名称 | 功能描述 |
|---|---|
first-principles-strategy | 第一性原理分析 |
pre-mortem | 事前验尸——计划失败预演 |
protoloop | 原型循环——Track Two 创新机制 |
快速启动流程
步骤 1:创建公司上下文
首次使用时,需要创建 company-context.md 文件。可从以下任一位置获取模板:
install/company-context.md— 完整模板install/skills/*.md— 各技能内的嵌入模板
步骤 2:确定运行模式
根据您的需求选择合适的模式:
graph TD
A[开始] --> B{是否有现有上下文?}
B -->|是| C{上下文是否陈旧?}
B -->|否| D[Diagnostic 模式]
C -->|是| D
C -->|否| E{是否有明确触发条件?}
E -->|是| F[Alert Triggers 模式]
E -->|否| G[Review 模式]步骤 3:执行策略会话
以 Diagnostic 模式为例的标准会话流程:
| 阶段 | 时长 | 目标 |
|---|---|---|
| Landscape | 5-10 分钟 | 理解问题,检测信号 |
| Framework Application | 15-30 分钟 | 应用选定的战略框架 |
| Synthesis | 10-15 分钟 | 整合发现,提出问题 |
| Next Steps | 5 分钟 | 明确后续行动 |
步骤 4:更新上下文
会话结束后,必须更新 company-context.md:
## Session Log
| Date | Skill(s) run | Key finding | Action taken | Next review |
|------|--------------|-------------|--------------|-------------|
| [日期] | [运行的技能] | [关键发现] | [采取的行动] | [下次回顾日期] |
最佳实践
导入公司上下文
在开始任何技能前,优先导入已有的公司上下文:
"I've read through your materials. Here's what stands out to me: [2-3 observations]. Before we start, tell me — does that match where the most important questions are, or am I looking at the wrong thing?"
资料来源:strategy-diagnostic/SKILL.md:26-30
无上下文时的起始问题
如果无法获取上下文,使用以下问题启动:
- 战略诊断:"Tell me what's going on. What brought you here today?"
- Wardley 映射:"What's the business, and who is the end user or customer?"
- VRIO 分析:"What are the 3-5 resources or capabilities you consider most important?"
- 事前验尸:"What's the plan or decision we're stress-testing?"
时间管理
| 技能类型 | 推荐时长 | 说明 |
|---|---|---|
| 战略诊断 | 30-60 分钟 | 不要仓促,专注于深度 |
| Wardley 映射 | 30-45 分钟 | 从草稿开始比空白页更有价值 |
| VRIO 分析 | 30+ 分钟 | 难以回答的问题往往最有价值 |
| 第一性原理 | 45+ 分钟 | 这是深度会话,需要时间消化 |
| 事前验尸 | 30-45 分钟 | 不适感是正常的,这正是价值所在 |
常见问题
Q: 支持哪些 LLM?
支持任何支持 Markdown 读取的大语言模型,包括但不限于 Claude、ChatGPT、Gemini。
Q: 如何选择使用哪个技能?
使用 strategy-diagnostic 作为入口点,该技能会自动检测需要运行哪些框架。
Q: `company-context.md` 可以多人同时编辑吗?
建议作为单一真相来源,由主要战略分析师维护。其他人可通过会话贡献信息,由分析师整合更新。
Q: 多久需要更新一次上下文?
建议季度回顾,但关键信息(如核心策略变化、重大组织调整)应立即更新。
下一步
- 深入阅读:选择感兴趣的技能,详细阅读其 SKILL.md 文件
- 创建上下文:基于
company-context.md模板创建您自己的上下文文件 - 运行诊断:使用
strategy-diagnostic开始您的第一次会话 - 探索 Wardley 映射:学习如何创建业务格局地图
系统架构
策略技能(Strategy Skills)是一个开源的AI引导战略框架系统,设计用于将任何大型语言模型转变为战略思维伙伴。该项目基于20年的咨询实践经验开发,完全免费、开放且模型无关 资料来源:[README.md:1-3]()。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
1. 项目概述
策略技能(Strategy Skills)是一个开源的AI引导战略框架系统,设计用于将任何大型语言模型转变为战略思维伙伴。该项目基于20年的咨询实践经验开发,完全免费、开放且模型无关 资料来源:README.md:1-3。
系统的核心设计理念是将复杂的战略分析方法论封装为结构化的技能(Skill),每个技能都是一个独立的Markdown文件,通过标准化的格式引导AI进行战略分析与决策支持。
2. 整体架构
2.1 架构分层模型
策略技能系统采用三层架构设计,各层之间通过标准化的接口进行通信:
graph TD
subgraph "表现层"
A[用户交互界面]
B[AI对话终端]
C[MCP客户端]
end
subgraph "技能层"
D[战略诊断技能]
E[战略映射技能]
F[Wardley地图技能]
G[VRIO分析技能]
H[环境雷达技能]
I[市场定位技能]
J[预演分析技能]
K[第一性原理技能]
L[原型循环技能]
end
subgraph "数据层"
M[公司上下文文件]
N[会话状态管理]
O[输出结果存储]
end
A --> B
B --> C
C --> D
C --> E
C --> F
D --> M
E --> M
F --> M
G --> M
H --> M2.2 核心组件说明
| 组件类型 | 组件名称 | 功能描述 | 源码位置 |
|---|---|---|---|
| 技能模块 | 战略诊断 | 作为入口点,AI引导的战略评估,检测应运行哪些框架 | strategy-diagnostic/SKILL.md |
| 技能模块 | 战略映射 | 从资源到结果、从期望到需求的因果链映射 | strategy-map/ |
| 技能模块 | Wardley地图 | 绘制业务环境地图的双轴分析 | wardley-map/SKILL.md |
| 技能模块 | VRIO分析 | 测试竞争优势是否真实、稀有且持久 | vrio-analysis/SKILL.md |
| 技能模块 | 环境雷达 | 持续PESTEL扫描外部力量 | environmental-radar/ |
| 技能模块 | 市场定位 | 竞争定位分析 | market-position/ |
| 数据存储 | 公司上下文 | 跨会话累积战略情报的共享文件 | install/company-context.md |
| 工具集成 | MCP服务器 | Model Context Protocol协议服务器 | mcp-server/ |
3. 技能框架结构
3.1 标准化技能模板
每个策略技能都遵循统一的Markdown格式规范,确保AI能够正确解析和执行 资料来源:SKILL-TEMPLATE.md:1-25:
graph LR
A[技能标题] --> B[上下文加载]
B --> C[模式判断]
C --> D{模式选择}
D -->|诊断模式| E[完整会话]
D -->|回顾模式| F[定期评估]
D -->|预警模式| G[触发器设置]
E --> H[阶段1]
F --> H
G --> H
H --> I[阶段2]
I --> J[阶段N]
J --> K[综合输出]
K --> L[上下文更新]3.2 技能执行模式
系统支持三种运行模式,通过统一的标准进行模式判断 资料来源:strategy-diagnostic/SKILL.md:18-35:
| 模式类型 | 适用场景 | 预计时长 | 特点 |
|---|---|---|---|
| 诊断模式 | 首次使用或重大变更后 | 30-60分钟 | 完整深度会话 |
| 回顾模式 | 周期性重新评估 | 15-20分钟 | 检查变化 |
| 预警模式 | 设置早期预警触发器 | 不定时 | 持续监控 |
3.3 技能通用结构
每个技能文件包含以下标准化部分:
# 技能标题
## 加载公司上下文
- 检查company-context.md是否存在
- 读取相关上下文信息
- 根据上下文决定开场方式
## 确定模式
- 诊断模式条件判断
- 回顾模式条件判断
- 预警模式条件判断
## 阶段1: [阶段名称]
- 实施步骤
- 提问问题
- 期望响应
## 阶段2: [阶段名称]
- ...
## 模式N: [模式名称]
## 综合输出
- 输出组件1
- 输出组件2
- 待解决问题
## 边界
- 明确不覆盖的范围
- 建议转接的技能
4. 数据管理架构
4.1 公司上下文文件结构
公司上下文文件(company-context.md)是跨会话累积战略情报的核心数据存储 资料来源:install/company-context.md:1-60:
graph TD
A[company-context.md] --> B[组织信息]
A --> C[业务描述]
A --> D[关键资源]
A --> E[客户信息]
A --> F[竞争格局]
A --> G[当前战略]
A --> H[财务状况]
A --> I[会话日志]
B --> B1[名称/行业/规模]
D --> D1[VRIO状态表格]
I --> I1[历史会话记录]4.2 上下文更新流程
sequenceDiagram
participant U as 用户
participant S as 技能模块
participant C as 公司上下文文件
U->>S: 开始会话
S->>C: 读取现有上下文
C-->>S: 返回上下文数据
S->>S: 分析与诊断
S->>U: 提问与交互
U-->>S: 响应
S->>S: 更新诊断状态
S->>C: 写入新发现
C-->>S: 确认保存5. 技能详细架构
5.1 战略诊断技能
战略诊断是整个系统的入口点,负责检测应该运行哪些框架并引导用户进行初步评估 资料来源:strategy-diagnostic/SKILL.md:1-50。
诊断状态在会话期间持续维护,指导探测决策和框架调用:
DIAGNOSTIC STATE
================
Organisation: [名称/行业/规模]
Presenting issue: [表面问题]
Emerging issue: [实际核心问题]
SIGNALS DETECTED:
- [信号] → suggests [框架]
5.2 Wardley地图技能
Wardley地图技能引导用户通过六个阶段构建业务环境地图 资料来源:install/skills/wardley-map.md:1-80:
| 阶段 | 名称 | 核心问题 |
|---|---|---|
| 1 | 锚点 | 从用户需求开始 |
| 2 | 价值链 | 确定组件依赖关系 |
| 3 | 演进轴 | 确定每个组件的演化阶段 |
| 4 | 锚定 | 在地图上定位 |
| 5 | 移动 | 分析战略动向 |
| 6 | 预警触发器 | 设置重新评估条件 |
5.3 VRIO分析技能
VRIO分析技能用于评估企业资源和能力的竞争价值,通过四个核心问题进行检验 资料来源:install/skills/vrio.md:1-45:
graph TD
A[VRIO分析框架] --> B[有价值吗?]
B -->|是| C[稀有吗?]
B -->|否| E[竞争劣势]
C -->|是| D[可模仿吗?]
C -->|否| F[暂时优势]
D -->|是| G[组织支持吗?]
D -->|否| H[持续优势]
G -->|是| I[竞争优势]
G -->|否| J[竞争均势]5.4 预演分析技能
预演分析技能通过假设失败场景来识别计划中的风险 资料来源:install/skills/pre-mortem.md:1-50。该技能与战略地图和Wardley地图紧密关联,确定计划在更广泛系统中的位置。
5.5 第一性原理技能
第一性原理技能帮助用户区分物理约束和常规约束 资料来源:install/skills/first-principles.md:1-40:
| 约束类型 | 定义 | 示例 |
|---|---|---|
| 物理约束 | 宇宙不允许违反的定律 | 光速、热力学 |
| 常规约束 | 习惯和传统形成的限制 | "一直是这样做的" |
5.6 原型循环技能
原型循环技能专注于Track Two创新机制的建立和保护 资料来源:install/skills/protoloop.md:1-50:
graph TD
A[原型循环技能] --> B[建立保护机制]
A --> C[识别摄入渠道]
A --> D[跟踪活跃循环]
A --> E[设计反制措施]
B --> B1[定义内部创业者]
B --> B2[确定赞助人]
B --> B3[设计预算保护]6. 技术实现架构
6.1 MCP服务器架构
项目包含一个Model Context Protocol服务器实现,用于工具集成 资料来源:mcp-server/package.json:1-20:
{
"dependencies": {
"@modelcontextprotocol/sdk": "^1.29.0",
"zod": "^3.25.0"
}
}
MCP服务器采用TypeScript开发,提供类型安全的消息传递和工具调用能力。
6.2 技能安装结构
graph TD
A[install/] --> B[skills/]
A --> C[company-context.md]
A --> D[STRATEGY.md]
B --> E[wardley-map.md]
B --> F[vrio.md]
B --> G[pre-mortem.md]
B --> H[first-principles.md]
B --> I[protoloop.md]7. 技能间关系与依赖
7.1 技能协作网络
graph TD
SD[战略诊断] --> SM[战略映射]
SD --> WM[Wardley地图]
SD --> VRIO[VRIO分析]
SD --> PM[预演分析]
SD --> FP[第一性原理]
SM --> WM
WM --> VRIO
WM --> PM
VRIO --> FP
PM --> WM
subgraph "共享数据"
CC[公司上下文]
end
SD -.-> CC
WM -.-> CC
VRIO -.-> CC
PM -.-> CC
FP -.-> CC7.2 技能边界定义
系统通过明确的边界定义避免技能间的冲突和重复 资料来源:SKILL-TEMPLATE.md:60-70:
| 技能 | 覆盖范围 | 明确排除 |
|---|---|---|
| 战略诊断 | 整体评估入口 | 具体分析方法 |
| Wardley地图 | 业务环境地图 | 资源能力分析 |
| VRIO分析 | 资源竞争价值 | 市场定位 |
| 预演分析 | 风险识别 | 环境扫描 |
8. 工作流程示例
8.1 完整诊断工作流
graph TD
A[开始诊断会话] --> B{存在公司上下文?}
B -->|是| C[读取现有上下文]
B -->|否| D[询问基本信息]
C --> E[开场反思]
D --> E
E --> F[阶段1: 景观扫描]
F --> G[收集信号]
G --> H[更新诊断状态]
H --> I[选择相关框架]
I --> J{选择框架}
J -->|Wardley| K[运行Wardley地图]
J -->|VRIO| L[运行VRIO分析]
J -->|预演| M[运行预演分析]
K --> N[综合输出]
L --> N
M --> N
N --> O[更新公司上下文]
O --> P[确定后续步骤]8.2 回顾模式工作流
当公司上下文已包含历史发现时,系统进入快速回顾模式 资料来源:strategy-diagnostic/SKILL.md:20-25:
- 读取现有上下文文件
- 验证上次发现是否仍然有效
- 识别自上次会话以来的变化
- 更新关键发现
- 设置新的预警触发器
9. 安装与部署
9.1 目录结构
strategy-skills/
├── README.md
├── SKILL-TEMPLATE.md
├── strategy-diagnostic/
│ └── SKILL.md
├── strategy-map/
├── vrio-analysis/
│ └── SKILL.md
├── wardley-map/
│ └── SKILL.md
├── environmental-radar/
├── market-position/
├── pre-mortem/
│ └── SKILL.md
├── first-principles-strategy/
│ └── SKILL.md
├── install/
│ ├── STRATEGY.md
│ ├── company-context.md
│ └── skills/
│ ├── wardley-map.md
│ ├── vrio.md
│ ├── pre-mortem.md
│ ├── first-principles.md
│ └── protoloop.md
└── mcp-server/
├── package.json
└── src/
9.2 技能加载流程
技能可通过两种方式加载:
- 直接读取:AI直接读取Markdown文件并按结构执行
- MCP工具调用:通过Model Context Protocol协议调用专用工具
10. 扩展机制
10.1 新增技能指南
添加新技能需要遵循以下规范:
| 要求项 | 说明 |
|---|---|
| 文件格式 | Markdown (.md) |
| 命名规范 | [技能名称]/SKILL.md |
| 必需部分 | 标题、模式判断、阶段定义、综合输出 |
| 可选部分 | 边界定义、预警触发器 |
| 数据存储 | 更新company-context.md |
10.2 上下文累积策略
所有技能共享一个公司上下文文件,确保战略情报的持续累积和跨会话一致性 资料来源:install/company-context.md:1-10。
会话日志跟踪每次运行的技能、关键发现和后续行动:
| 日期 | 运行技能 | 关键发现 | 采取行动 | 下次审查 |
|---|---|---|---|---|
| YYYY-MM-DD | 技能名称 | 发现描述 | 决策内容 | 日期 |
来源:https://github.com/eterdis/strategy-skills / 项目说明书
MCP 服务器集成
MCP 服务器集成是 strategy-skills 项目的核心组件,它将 11 个开放战略框架通过 Model Context Protocol (MCP) 协议暴露为 AI 引导提示。该服务器基于 20 年咨询实践构建,采用 CC-BY-4.0 开源许可证,完全模型无关。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
概述
MCP 服务器集成是 strategy-skills 项目的核心组件,它将 11 个开放战略框架通过 Model Context Protocol (MCP) 协议暴露为 AI 引导提示。该服务器基于 20 年咨询实践构建,采用 CC-BY-4.0 开源许可证,完全模型无关。
资料来源:mcp-server/package.json:4
graph TB
subgraph MCP生态系统
A[AI 客户端<br/>Claude/ChatGPT/Gemini] --> B[MCP 协议层]
B --> C[@eterdis/strategy-skills-mcp]
C --> D[策略框架集合]
D --> E[company-context.md<br/>共享上下文]
end
subgraph 策略框架
F[strategy-diagnostic]
G[wardley-map]
H[strategy-map]
I[vrio-analysis]
J[environmental-radar]
K[market-position]
end
C --> F
C --> G
C --> H
C --> I
C --> J
C --> K技术架构
核心依赖
| 依赖包 | 版本 | 用途 |
|---|---|---|
| @modelcontextprotocol/sdk | ^1.29.0 | MCP 协议实现 |
| zod | ^3.25.0 | 数据验证与类型安全 |
| typescript | ^5.7.0 | TypeScript 类型支持 |
| @types/node | ^22.0.0 | Node.js 类型定义 |
资料来源:mcp-server/package.json:24-29
项目结构
mcp-server/
├── package.json # 包配置与依赖声明
├── build/ # 编译输出目录
├── content/ # 策略框架内容目录
├── src/
│ └── index.ts # MCP 服务器入口
└── scripts/
└── copy-content.mjs # 内容复制脚本
资料来源:mcp-server/package.json:12-16
构建流程
NPM 脚本配置
| 脚本命令 | 功能描述 |
|---|---|
npm run copy-content | 复制策略框架内容到构建目录 |
npm run build | 执行内容复制 + TypeScript 编译 |
npm run prepublishOnly | 发布前自动构建 |
构建流程首先执行 copy-content 脚本将 content/ 目录中的策略框架文件复制到构建产物,然后调用 TypeScript 编译器生成 JavaScript 输出。
资料来源:mcp-server/package.json:10-14
MCP 服务器配置
包元数据
| 配置项 | 值 |
|---|---|
| NPM 包名 | @eterdis/strategy-skills-mcp |
| MCP 协议名 | io.github.eterdis/strategy-skills |
| 版本号 | 1.0.1 |
| 许可协议 | CC-BY-4.0 |
| 发布类型 | ES Module |
| CLI 入口 | eterdis-strategy-skills-mcp |
资料来源:mcp-server/package.json:1-8
发布文件配置
{
"files": ["build", "content"]
}
构建产物 build/ 和策略内容 content/ 目录将被包含在 npm 包中,确保运行时能够访问所有策略框架资源。
资料来源:mcp-server/package.json:15-18
策略框架集成
框架类型
项目集成了以下策略框架作为 MCP 工具:
| 框架名称 | 功能描述 | 运行模式 |
|---|---|---|
| strategy-diagnostic | 入口点 — AI 引导的战略评估,检测应运行哪些框架 | 诊断/审查/警报 |
| strategy-map | 资源到结果的因果链映射 | 诊断/审查/警报 |
| vrio-analysis | 测试竞争优势是否真实、稀有且持久 | 诊断/审查/警报 |
| environmental-radar | 持续 PESTEL 扫描外部力量 | 诊断/审查/警报 |
| market-position | 竞争定位分析 | 诊断/审查/警报 |
| wardley-map | Wardley 价值链与演化地图 | 诊断/审查/警报 |
资料来源:strategy-diagnostic/SKILL.md:1-50、wardley-map/SKILL.md:1-30
通用运行模式
stateDiagram-v2
[*] --> 诊断模式: 首次使用/计划变更
诊断模式 --> 审查模式: 已有发现/定期重评
审查模式 --> 警报触发模式: 设置监控条件
警报触发模式 --> 审查模式: 触发条件满足
审查模式 --> 诊断模式: 重大变更所有框架支持三种运行模式:
- 诊断模式 — 深入首次使用会话(30-60 分钟)
- 审查模式 — 周期性重新评估(15-20 分钟)
- 警报触发模式 — 设置早期预警监控条件
资料来源:strategy-diagnostic/SKILL.md:50-80
共享上下文机制
company-context.md 角色
所有策略框架读写共享的 company-context.md 文件,该文件跨会话累积战略情报:
graph LR
A[会话 1] --> B[company-context.md]
B --> A
C[会话 2] --> B
B --> C
D[会话 N] --> B
B --> D关键配置项包括:
| 配置项 | 描述 |
|---|---|
| Organisation | 组织基本信息(行业、规模、地理、所有权) |
| What pays the bills | 商业模式描述 |
| Resources that matter | 核心资源与 VRIO 状态 |
| Customers | 客户分群与流失原因 |
| Competitive landscape | 竞争格局分析 |
| Current strategy | 当前战略(一段话描述) |
| Financial situation | 财务状况(收入、利润率、现金流) |
资料来源:install/company-context.md:1-60
诊断状态管理
每个会话维护内部诊断状态,驱动后续提问方向:
DIAGNOSTIC STATE
================
Organisation: [name, industry, size when known]
Presenting issue: [what they said first]
Emerging issue: [what you think is actually going on]
SIGNALS DETECTED:
- [signal] → suggests [framework]
CONTRADICTIONS:
- [they said X about topic A, but Y about topic B]
FRAMEWORKS INVOKED:
- [framework name] → [key finding]
资料来源:strategy-diagnostic/SKILL.md:20-40
框架工作流示例
Strategy-Diagnostic 工作流
graph TD
A[Phase 1: Landscape<br/>5-10 分钟] --> B{检测信号}
B -->|2-3 个框架| C[Phase 2: Probing<br/>15-25 分钟]
B -->|信号明确| D[直接调用框架]
C --> E[Phase 3: Synthesis<br/>输出发现]
D --> E
E --> F[更新 company-context.md]#### Phase 1: Landscape(5-10 分钟)
以开放式问题开始,倾听并检测框架信号:
"Tell me what's going on. What brought you here today?"
后续追问(选择 2-3 个):
- "未来 12 个月最大的决策是什么?"
- "如果随机问一个员工战略是什么——他们会怎么说?"
- "你们已经尝试了什么?是什么导致失败?"
资料来源:strategy-diagnostic/SKILL.md:50-80
#### Phase 2: Probing(15-25 分钟)
调用相关框架时不要宣布,直接提问。框架是引擎,对话是汽车。
Wardley Map 工作流
graph TD
A[Phase 1: Anchor<br/>用户需求锚定] --> B[Phase 2: Value Chain<br/>依赖链构建]
B --> C[Phase 3: Evolution<br/>演化轴定位]
C --> D[Phase 4: Strategic Plays<br/>战略玩法识别]
D --> E[输出地图到上下文]资料来源:wardley-map/SKILL.md:30-60
First Principles 工作流
graph LR
A[识别约束] --> B{约束类型}
B -->|物理约束| C[不可违反]
B -->|惯例约束| D[可质疑/打破]
C --> E[工作向后推导]
D --> E
E --> F[差距分析]
F --> G[设计解决方案]物理约束是宇宙不允许违反的(如光速、热力学),惯例约束是习惯和惯例。
资料来源:first-principles-strategy/SKILL.md:1-40
Pre-Mortem 工作流
在计划执行前进行压力测试:
- 设想计划已经失败
- 逆向推导失败原因
- 识别主动假设
- 进行猴子测试(如果计划失败,谁会首先注意到?)
关键词与分类
| 分类 | 关键词 |
|---|---|
| 协议 | mcp, model-context-protocol |
| 领域 | strategy, consulting, ai-agent, frameworks |
| 分析方法 | vrio, wardley-map, playing-to-win |
| 平台 | claude, chatgpt, gemini |
资料来源:mcp-server/package.json:19-22
快速开始
安装依赖
cd mcp-server
npm install
构建项目
npm run build
使用 MCP 客户端
配置 MCP 客户端连接至 eterdis-strategy-skills-mcp 服务即可开始使用策略框架。
扩展机制
项目设计支持扩展新框架:
- 在
content/目录创建新的SKILL.md文件 - 遵循 SKILL.md 格式规范
- 更新 MCP 服务器以注册新工具
- 在
company-context.md中添加对应配置节
相关资源
| 资源 | 链接 |
|---|---|
| 项目主页 | https://eterdis.com/skills/ |
| NPM 包 | https://www.npmjs.com/package/@eterdis/strategy-skills-mcp |
| 作者 | Eterdis AS (https://eterdis.com) |
| GitHub | https://github.com/eterdis/strategy-skills |
技能目录
技能目录(Skills)是 Eterdis Strategy Skills 项目的核心组件,定义了九个战略框架技能,用于将任何大型语言模型转变为战略思维伙伴。每个技能都是一个独立的 Markdown 文件,采用 Agent Skills 格式,引导用户完成经过验证的战略方法论。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
概述
技能目录(Skills)是 Eterdis Strategy Skills 项目的核心组件,定义了九个战略框架技能,用于将任何大型语言模型转变为战略思维伙伴。每个技能都是一个独立的 Markdown 文件,采用 Agent Skills 格式,引导用户完成经过验证的战略方法论。
这些技能基于 20 年咨询实践经验开发,完全免费、开源且模型无关,可与 Claude、ChatGPT、Gemini 或任何支持 Markdown 的模型配合使用。
资料来源:README.md:1-15
技能架构
整体分类
项目中的技能按照战略分析的不同维度进行组织,分为四个主要类别:
| 类别 | 技能名称 | 用途定位 |
|---|---|---|
| 入口与诊断 | strategy-diagnostic | 战略评估入口点,检测应运行哪个框架 |
| 因果与演进 | strategy-map、wardley-map | 资源到结果的因果链映射 |
| 资源与优势 | vrio-analysis | 测试竞争优势的真实性与持久性 |
| 外部与内部 | environmental-radar、market-position | 内外部环境扫描与定位 |
技能关系图
graph TD
A[战略诊断入口] --> B[战略地图]
A --> C[VRIO分析]
A --> D[Wardley地图]
A --> E[环境雷达]
A --> F[市场定位]
B --> G[第一性原理]
G --> H[事前分析]
F --> H
D --> H资料来源:README.md:18-30
入口技能
战略诊断(strategy-diagnostic)
文件路径: strategy-diagnostic/SKILL.md
战略诊断是整个项目的入口技能,作为 AI 引导的战略评估工具,用于检测应运行哪个框架。它提供三种运行模式:
| 模式 | 适用场景 | 预计时长 |
|---|---|---|
| 诊断(Diagnostic) | 深度首次会话 | 30-60 分钟 |
| 回顾(Review) | 周期性重新评估 | 15-20 分钟 |
| 预警触发器(Alert Triggers) | 监控会话间隔期 | 按需 |
该技能维护一个内部诊断状态,追踪组织信息、呈现问题、检测到的信号、矛盾点和已调用的框架。
资料来源:strategy-diagnostic/SKILL.md:1-50
战略映射技能
战略地图(strategy-map)
战略地图用于将资源到结果的因果链进行可视化映射,回答以下核心问题:
- 当前战略期望实现什么结果?
- 需要哪些能力和行动来实现这些结果?
- 如何跟踪和衡量进展?
资料来源:README.md:20
Wardley 地图(wardley-map)
文件路径: wardley-map/SKILL.md
Wardley 地图是一种商业景观地图,包含两个轴:
graph LR
subgraph 垂直轴-价值链
UN[用户需求]
CA[组件A]
CB[组件B]
CC[组件C]
end
subgraph 水平轴-演进
G[Genesis<br/>创世]
C[Custom<br/>定制]
P[Product<br/>产品]
CO[Commodity<br/>商品化]
end
UN --> CA
CA --> CB
CB --> CC核心阶段定义:
| 阶段 | 名称 | 特征 |
|---|---|---|
| Stage 1 | Genesis(创世) | 全新、实验性、未知结果 |
| Stage 2 | Custom(定制) | 定制开发、独特解决方案 |
| Stage 3 | Product(产品) | 可购买、市场存在 |
| Stage 4 | Commodity(商品化) | 基础设施、实用程序 |
Wardley 地图的构建分为三个主要阶段:
- 锚定 — 从用户需求出发,而非产品或技术
- 价值链 — 识别组件依赖关系
- 演进轴 — 确定每个组件在进化曲线上的位置
资料来源:wardley-map/SKILL.md:1-80
资源分析技能
VRIO 分析(vrio-analysis)
文件路径: vrio-analysis/SKILL.md
VRIO 分析(Jay Barney, 1991)用于评估企业资源和能力的竞争优势。该框架提出四个关键问题:
flowchart TD
A[资源/能力] --> B{有价值的?}
B -->|否| F[竞争劣势]
B -->|是| C{稀有的?}
C -->|否| E[竞争均势]
C -->|是| D{难以模仿的?}
D -->|否| G[暂时优势]
D -->|是| H{被组织开发的?}
H -->|否| I[暂时优势]
H -->|是| J[持续竞争优势]VRIO 评估框架:
| 维度 | 问题 | 评估标准 |
|---|---|---|
| V - 有价值(Valuable) | 资源是否使企业能够利用机会或抵御威胁? | 是/否 |
| R - 稀有(Rare) | 有多少竞争对手拥有这种资源? | 是/否 |
| I - 难以模仿(Inimitable) | 没有这种资源的企业要付出多大代价? | 是/否 |
| O - 组织性(Organization) | 企业是否准备好利用这种资源? | 是/否 |
资料来源:vrio-analysis/SKILL.md:1-60
环境分析技能
环境雷达(environmental-radar)
环境雷达提供持续的 PESTEL 扫描,监测影响组织下一步决策的外部力量。PESTEL 分析涵盖:
- Political(政治)
- Economic(经济)
- Social(社会)
- Technological(技术)
- Environmental(环境)
- Legal(法律)
资料来源:README.md:25
市场定位(market-position)
市场定位技能分析企业在竞争格局中的实际位置,而非幻灯片上声称的位置。该技能帮助回答:
- 目标客户实际如何认知你的产品?
- 你的真实差异化因素是什么?
- 竞争对手对你的看法与你自己有何不同?
资料来源:README.md:26
决策支持技能
事前分析(pre-mortem)
文件路径: pre-mortem/SKILL.md
事前分析是一种前瞻性风险识别技术,在计划实施前预演可能的失败。该技能支持三种模式:
| 模式 | 说明 |
|---|---|
| 诊断模式 | 首次进行全面分析 |
| 回顾模式 | 检查失败因素是否已改变 |
| 预警触发器模式 | 定义早期预警信号 |
核心分析要素:
- 识别活跃假设
- 预演失败场景
- 设计应对措施
- 更新公司上下文文档
第一性原理策略(first-principles-strategy)
文件路径: first-principles-strategy/SKILL.md
第一性原理策略用于打破传统假设,重新审视约束条件。该技能区分两类约束:
| 约束类型 | 定义 | 示例 |
|---|---|---|
| 物理约束 | 宇宙不允许违反的自然法则 | 光速、热力学 |
| 传统约束 | 约定俗成的做事方式 | 行业惯例、历史做法 |
该技能引导用户通过六个阶段:
- 定义理论最大值
- 识别当前差距
- 分析阻碍因素
- 质疑假设
- 设计新路径
- 反推至当前行动
资料来源:first-principles-strategy/SKILL.md:1-60
创新机制技能
原型循环(protoloop-setup)
文件路径: protoloop-setup/SKILL.md
原型循环技能帮助组织建立持续创新机制,核心概念包括:
双轨模型:
graph TD
subgraph Track1[主业务轨道]
T1A[日常运营]
T1B[现有产品]
T1C[已知客户]
end
subgraph Track2[原型循环轨道]
T2A[探索性实验]
T2B[新兴技术]
T2C[战略溢出]
end
T1A -.->|资源竞争| T2A
T2A -.->|成功孵化| T1A关键角色:
| 角色 | 职责 |
|---|---|
| 内部创业者(Intrapreneurs) | 分配时间进行探索性工作 |
| 赞助者(Sponsor) | 提供保护和资源 |
| 备份赞助者 | 赞助者缺席时的后备 |
保护机制设计:
- 识别主要抗体风险(如预算削减、人员抽调)
- 设计防御机制
- 建立升级路径
资料来源:protoloop-setup/SKILL.md:1-80
共享上下文机制
公司上下文文件
所有技能共享一个 company-context.md 文件,该文件:
- 跨会话累积战略情报
- 在每次会话后更新
- 作为技能的起始参考点
文件结构:
| 章节 | 内容 |
|---|---|
| 组织信息 | 名称、行业、规模、地理位置 |
| 业务描述 | 销售内容、目标客户、盈利方式 |
| 关键资源 | 3-5 项不可替代的资源或能力 |
| 客户信息 | 核心细分市场、选择原因、流失风险 |
| 竞争格局 | 竞争对手分析表 |
| 当前战略 | 一段话描述 |
| 财务状况 | 收入趋势、利润率、现金状况 |
| 会话日志 | 历史技能运行记录 |
资料来源:install/company-context.md:1-50
技能运行模式
所有技能支持三种标准运行模式:
诊断模式
- 触发条件: 首次运行或计划有重大变化
- 执行内容: 完整深度分析
- 时间预期: 30-60 分钟
回顾模式
- 触发条件: 之前已完成诊断,存在历史记录
- 执行内容: 检查变化、更新状态
- 时间预期: 15-20 分钟
预警触发器模式
- 触发条件: 设定或检查监控条件
- 执行内容: 定义或验证早期预警信号
- 时间预期: 按需
stateDiagram-v2
[*] --> 诊断模式: 首次运行
诊断模式 --> 回顾模式: 完成首次分析
回顾模式 --> 诊断模式: 重大变化发生
诊断模式 --> 预警触发器: 设定监控
回顾模式 --> 预警触发器: 更新触发条件
预警触发器 --> 诊断模式: 触发条件满足资料来源:strategy-diagnostic/SKILL.md:15-30
技能模板结构
每个技能文件遵循统一的 SKILL.md 格式:
| 区域 | 内容 |
|---|---|
| 元数据 | 名称、描述、主页链接 |
| 上下文加载 | 如何读取和使用 company-context.md |
| 技能介绍 | 工具用途、使用场景、解决的问题 |
| 阶段/步骤 | 具体执行步骤和提问方式 |
| 模式选择 | 三种模式的切换逻辑 |
| 边界定义 | 技能不覆盖的范围 |
| 输出格式 | 合成结果的呈现方式 |
最佳实践
技能选择流程
flowchart TD
A[开始战略讨论] --> B{有公司上下文?}
B -->|是| C[读取上下文]
B -->|否| D[提问开场问题]
C --> E[运行战略诊断]
D --> E
E --> F[检测信号]
F --> G{选择合适技能}
G --> H[执行选定技能]
H --> I[更新上下文]
I --> J[记录会话日志]跨技能协作
- 战略诊断可作为入口,决定调用哪个具体技能
- Wardley 地图与事前分析常配合使用
- VRIO 分析可为市场定位提供资源基础
- 第一性原理策略可用于打破原型循环中的障碍
会话管理
每次技能运行后必须更新 company-context.md,包括:
- 新发现的关键信息
- 更新的评估结论
- 下次审查的待办事项
- 会话日志条目
资料来源:install/company-context.md:45-50
扩展与定制
添加新技能
要添加新技能,需遵循模板结构:
- 创建新目录,如
new-skill/ - 创建
SKILL.md文件 - 在 README.md 的技能表中添加条目
- 定义技能的触发条件和边界
技能本地化
所有技能文件采用 Markdown 格式,支持:
- 翻译为其他语言
- 调整提问措辞
- 添加组织特定场景
总结
技能目录构成了 Eterdis Strategy Skills 的核心框架体系,提供从战略诊断到创新机制的全方位战略思维支持。通过标准化的 SKILL.md 格式和共享的上下文机制,这些技能能够协作运行,帮助组织进行系统化战略思考。
各技能之间的关系可概括为:
- 诊断技能 识别问题类型
- 映射技能 理解因果结构
- 分析技能 评估资源和位置
- 决策技能 预演风险和可能性
- 创新技能 推动持续变革
资料来源:README.md:1-15
诊断类技能
诊断类技能是策略技能库中的核心入口模块,设计用于通过 AI 引导的对话方式执行战略评估与诊断。这类技能遵循统一的 SKILL.md 格式规范,能够与任何支持 Markdown 的大型语言模型配合工作,将模型转变为战略思维伙伴。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
概述
诊断类技能是策略技能库中的核心入口模块,设计用于通过 AI 引导的对话方式执行战略评估与诊断。这类技能遵循统一的 SKILL.md 格式规范,能够与任何支持 Markdown 的大型语言模型配合工作,将模型转变为战略思维伙伴。
诊断类技能的核心价值在于探测与定位——通过结构化的提问、模式识别和矛盾检测,帮助用户识别当前战略环境中的关键问题,并决定下一步应该调用哪些具体的分析框架。资料来源:strategy-diagnostic/SKILL.md
技能架构
诊断类技能库采用分层架构设计:
graph TD
A[诊断类技能] --> B[战略诊断 skill-diagnostic]
A --> C[战略映射 skill-map]
A --> D[VRIO分析 vrio-analysis]
A --> E[环境雷达 environmental-radar]
A --> F[市场定位 market-position]
A --> G[沃德利地图 wardley-map]
A --> H[文化评估 culture-assessment]
B --> I[company-context.md]
C --> I
D --> I
E --> I
F --> I
G --> I
H --> I
style A fill:#e1f5fe
style I fill:#fff3e0所有诊断类技能共享同一个 company-context.md 上下文文件,该文件作为跨会话的战略信息积累载体,确保每次会话都能在前一次分析的基础上继续推进。资料来源:strategy-diagnostic/SKILL.md
运作模式
诊断类技能支持三种标准运作模式,适用于不同的使用场景和时间投入:
| 模式 | 用途 | 预计时长 | 触发条件 |
|---|---|---|---|
| Diagnostic | 深度首次诊断会话 | 30-60 分钟 | 首次运行或计划发生重大变化 |
| Review | 周期性重新评估 | 15-20 分钟 | 已有诊断结果,需检查是否需要更新 |
| Alert Triggers | 早期预警监控 | 10-15 分钟 | 定义或检查特定预警触发条件 |
资料来源:strategy-diagnostic/SKILL.md
战略诊断技能(strategy-diagnostic)
战略诊断技能是整个诊断类技能体系的入口点,负责识别应该运行哪些分析框架。
诊断状态管理
诊断技能在会话过程中维护一个内部诊断状态,用于指导提问方向和框架调用决策:
DIAGNOSTIC STATE
================
Organisation: [name, industry, size when known]
Presenting issue: [what they said first]
Emerging issue: [what you think is actually going on — update as you learn]
SIGNALS DETECTED:
- [signal] → suggests [framework]
- [signal] → suggests [framework]
CONTRADICTIONS:
- [they said X about topic A, but Y about topic B — these don't reconcile]
FRAMEWORKS INVOKED:
- [framework name] → [key finding]
KEY FINDINGS:
1. [finding]
2. [finding]
OPEN QUESTIONS:
- [what you still don't know]
此状态不向用户展示,仅作为 AI 引导会话的内部决策依据。资料来源:strategy-diagnostic/SKILL.md
第一阶段:全局概览(Landscape)
这是诊断的起始阶段,目标是建立对用户处境的整体理解。
#### 开场问题
使用单一开放性问题启动对话:
"Tell me what's going on. What brought you here today?"
随后保持沉默,让用户自由表达。这个阶段的关键是倾听,而非结构化提问。
#### 跟进问题(根据用户回应选择 2-3 个)
- "What's the biggest decision you need to make in the next 12 months?"
- "If I grabbed a random person from your shop floor right now and asked them what the strategy is — what would they say?"
- "What have you already tried? And what killed it?"
- "Who in the organisation thinks the problem is something completely different?"
- "If you got hit by a bus and someone parachuted in as CEO tomorrow — what would they change in the first 90 days?"
- "What's the thing you know you should do but keep finding reasons not to?"
资料来源:strategy-diagnostic/SKILL.md
其他诊断类技能
VRIO分析技能(vrio-analysis)
VRIO 分析技能用于测试竞争优势的真实性、稀缺性和持久性。
| 核心问题 | 分析维度 |
|---|---|
| Valuable? | 资源是否能利用机会或抵消威胁? |
| Rare? | 有多少竞争对手拥有此资源? |
| Imitable? | 复制该资源的成本有多高? |
| Organised? | 组织是否具备捕获价值的体系? |
VRIO 框架源自 Jay Barney 1991 年的研究成果,是竞争优势的"测谎仪"。资料来源:vrio-analysis/SKILL.md
环境雷达技能(environmental-radar)
环境雷达技能执行持续的 PESTEL 扫描,监控塑造组织下一步行动的外力:
| 维度 | 关注内容 |
|---|---|
| Political | 政策、选举、监管变化 |
| Economic | 通胀、利率、供应链成本 |
| Social | 人口结构、价值观、消费行为 |
| Technological | 颠覆性技术、数字化转型 |
| Environmental | ESG、气候风险、碳排放 |
| Legal | 劳动法、数据保护、诉讼风险 |
资料来源:environmental-radar/SKILL.md
市场定位技能(market-position)
市场定位技能分析组织的实际竞争位置,而非管理层设想的位置。该技能通过系统性对比揭示真实的市场地位:
graph LR
A[自身定位] --> B{是否存在差距?}
B -->|是| C[实际定位分析]
B -->|否| D[保持现状监控]
C --> E[竞争策略调整]
D --> F[定期复核]沃德利地图技能(wardley-map)
沃德利地图技能绘制组织的业务景观图,包含两个核心维度:
| 维度 | 含义 |
|---|---|
| 纵轴:价值链 | 从用户需求向下追溯至基础设施 |
| 横轴:进化阶段 | 组件从Genesis→Custom Built→Product→Commodity的演进 |
进化阶段的定义:
| 阶段 | 特征 | 示例 |
|---|---|---|
| Genesis | 全新实验,尚未验证 | 1880年的电力应用 |
| Custom Built | 定制解决方案 | 早期工厂发电系统 |
| Product | 可购买的产品 | 发电机 |
| Commodity | 标准化公用事业 | 电网供电 |
资料来源:wardley-map/SKILL.md
战略映射技能(strategy-map)
战略映射技能建立从资源到结果的因果链:
| 映射维度 | 核心问题 |
|---|---|
| 期望层 | 利益相关者期望什么? |
| 要求层 | 满足期望需要什么? |
| 执行层 | 如何交付这些要求? |
| 资源层 | 需要哪些资源支撑执行? |
文化评估技能(culture-assessment)
文化评估技能分析组织文化对战略执行的影响,包括文化基因、行为模式和潜在阻力。
资料来源:culture-assessment/SKILL.md
与公司上下文的集成
所有诊断类技能共享 company-context.md 文件,该文件作为战略信息的中央存储库:
graph TD
A[新会话开始] --> B{是否存在 company-context.md?}
B -->|是| C[读取现有上下文]
B -->|否| D[通过提问建立基础]
C --> E[AI引导诊断]
D --> E
E --> F[更新 company-context.md]
F --> G[下次会话使用]
style F fill:#c8e6c9
style G fill:#c8e6c9company-context.md 标准结构
| 章节 | 内容 |
|---|---|
| Organisation | 组织名称、行业、规模、地理位置、所有权 |
| What pays the bills | 当前业务描述 |
| Resources that matter | 3-5 个关键资源/能力 |
| Customers | 真实客户而非目标市场 |
| Competitive landscape | 竞争对手分析表 |
| Current strategy | 一段式策略描述 |
| Financial situation | 收入趋势、利润率、现金流 |
资料来源:install/company-context.md
技能选择决策流程
当用户启动诊断时,系统通过以下流程选择合适的技能框架:
graph TD
A[战略诊断会话开始] --> B[收集初始信息]
B --> C{是否有现有上下文?}
C -->|是| D[检测已有诊断结果]
C -->|否| E[从开场问题开始]
D --> F{上次诊断是否完整?}
F -->|否| G[选择缺失框架继续]
F -->|是| H[进入Review模式]
E --> I[信号检测]
G --> I
H --> J[检查预警触发器]
I --> K{检测到哪些信号?}
J --> K
K --> L[调用对应分析技能]
L --> M[更新诊断状态]
M --> N{是否需要多个框架?}
N -->|是| K
N -->|否| O[生成综合输出]
O --> P[更新 company-context.md]关键设计原则
- 上下文优先:优先使用
company-context.md中的现有信息,避免重复构建 - 信号驱动:通过检测到的信号动态决定调用哪些框架,而非机械执行全部框架
- 矛盾标记:识别并标记用户表述中的矛盾,这些往往是关键洞察的来源
- 迭代更新:每次会话后更新上下文文件,确保战略情报的持续积累
- 模式识别:识别经验丰富的从业者能够识别的常见模式
资料来源:strategy-diagnostic/SKILL.md
使用建议
| 场景 | 推荐模式 | 建议频率 |
|---|---|---|
| 首次战略评估 | Diagnostic | 按需 |
| 季度战略复核 | Review | 每季度 |
| 月度快速检查 | Review | 每月 |
| 新威胁/机会出现 | Alert Triggers | 按需 |
| 重大战略变化 | Diagnostic | 按需 |
诊断类技能的设计初衷是让组织能够在有限时间内获得结构化的战略洞察,通过模式化的框架和明确的输出格式,确保诊断结果的可用性和可追溯性。
决策与构建类技能
决策与构建类技能是策略技能库中专注于战略规划、方案构建与风险预判的核心模块。这套技能帮助用户在复杂商业环境中进行系统性思考,从发现战略问题、构建解决方案到预判失败模式,形成完整的决策支持链条。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
概述
决策与构建类技能是策略技能库中专注于战略规划、方案构建与风险预判的核心模块。这套技能帮助用户在复杂商业环境中进行系统性思考,从发现战略问题、构建解决方案到预判失败模式,形成完整的决策支持链条。
与诊断类技能(帮助用户发现"是什么问题")不同,决策与构建类技能更关注"我们应该如何行动"和"我们的计划会失败吗"。资料来源:SKILL-TEMPLATE.md:1-10
技能分类
决策与构建类技能涵盖以下核心工具:
| 技能名称 | 核心用途 | 使用场景 |
|---|---|---|
| First Principles(第一性原理) | 从物理约束出发拆解假设 | 打破常规思维、重构业务模式 |
| Pre-mortem(事前验尸) | 预判计划失败原因 | 重大决策前、方案评审 |
| Protoloop(创新回路) | 保护内部创新不被主流吞噬 | 建立第二增长曲线 |
| Wardley Map(沃德利地图) | 绘制业务演进地图 | 理解行业演变、寻找战略机会 |
| Playing to Win(制胜策略) | 构建可执行的竞争战略 | 战略选择与资源配置 |
资料来源:strategy-diagnostic/SKILL.md:1-20, README.md:1-30
技能详解
第一性原理策略(First Principles Strategy)
#### 核心概念
第一性原理策略是一种从零开始重构问题的方法论。它区分两类约束:
- 物理约束:宇宙无法违背的客观限制,如光速、热力学定律、材料强度
- 常规约束:人为形成的习惯、惯例、"历来如此"的做事方式
资料来源:first-principles-strategy/SKILL.md:40-55
#### 运作模式
第一性原理策略支持三种运作模式:
graph TD
A[开始分析] --> B{是否存在已有分析?}
B -->|是| C[Review 模式 - 回顾现有分析]
B -->|否| D{是否存在上下文文件?}
D -->|是| E[Diagnostic 模式 - 完整诊断]
D -->|否| F[Diagnostic 模式 - 完整诊断]
C --> G{用户选择}
E --> G
F --> G
G --> H[Alert Triggers 模式 - 设置预警触发器]Diagnostic 模式(完整诊断) 预计耗时45分钟以上,适合首次运行或重大战略重构。资料来源:first-principles-strategy/SKILL.md:25-35
#### 关键阶段
| 阶段 | 内容 | 产出 |
|---|---|---|
| Phase 1 | 锚定理论最大值 | 确定在物理约束下的最优解 |
| Phase 2 | 识别约束 | 区分物理约束与常规约束 |
| Phase 3 | 打破常规 | 质疑并重构习惯性假设 |
| Phase 4 | 构建新方案 | 从第一性原理重新设计路径 |
| Phase 5 | 差距分析 | 对比现状与理论最大值的差距 |
| Phase 6 | 回溯至今 | 制定从当前到目标的行动方案 |
上下文管理
上下文管理是 Eterdis Strategy Skills 框架中的核心持久化机制,用于在多次会话之间累积和传递战略情报。所有技能模块通过共享的 company-context.md 文件实现跨会话状态保持,确保 AI 代理能够基于历史分析持续深化战略洞察。
继续阅读本节完整说明和来源证据。
概述
上下文管理是 Eterdis Strategy Skills 框架中的核心持久化机制,用于在多次会话之间累积和传递战略情报。所有技能模块通过共享的 company-context.md 文件实现跨会话状态保持,确保 AI 代理能够基于历史分析持续深化战略洞察。
该系统解决了 AI 对话式战略咨询中的关键问题:每次会话不应从头开始,而应继承已收集的信息并在此基础上继续演进。上下文文件作为"活文档"被所有技能读取和更新,形成一个累积式的战略知识库。
资料来源:README.md:1-15
资料来源:README.md:1-15
技能开发模板
技能开发模板(Skill Template)是 Eterdis Strategy Skills 项目的核心组成部分,为开发者提供创建标准化 AI 策略思维伙伴的结构化框架。该模板基于 20 年咨询实践经验设计,遵循 Agent Skills 规范 的 SKILL.md 格式要求。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
概述
技能开发模板(Skill Template)是 Eterdis Strategy Skills 项目的核心组成部分,为开发者提供创建标准化 AI 策略思维伙伴的结构化框架。该模板基于 20 年咨询实践经验设计,遵循 Agent Skills 规范 的 SKILL.md 格式要求。
核心定位: 技能是一系列结构化提示词,引导大语言模型(LLM)通过经过验证的战略框架,向用户提出正确的问题、发现模式、揭示矛盾并产出可操作的输出。
技术特性:
- 模型无关性 — 支持 Claude、ChatGPT、Gemini 及任何支持 Markdown 读取的模型
- 标准化结构 — 统一的三模式运行机制(诊断、回顾、预警触发)
- 上下文持久化 — 通过共享的
company-context.md文件累积战略智能 - 对话驱动 — 通过 AI 引导的对话而非静态文档完成策略分析
资料来源:README.md:1-15
模板整体结构
技能模板采用模块化架构,由元数据区、上下文加载区、主体内容区和边界定义区四部分组成。
graph TD
A[SKILL.md] --> B[元数据区<br/>name/description/homepage]
A --> C[上下文加载区<br/>company-context.md]
A --> D[主体内容区<br/>阶段/步骤定义]
A --> E[边界定义区<br/>NOT covered]
D --> D1[Phase 1: 阶段名称]
D --> D2[Phase 2: 阶段名称]
D --> D3[Patterns & Red Flags]
D --> D4[Synthesis]
C --> C1[存在上下文?]
C1 -->|是| C2[打开并反映]
C1 -->|否| C3[开场问题]元数据规范
每个技能文件必须包含以下 YAML frontmatter 字段:
| 字段 | 必需 | 说明 | 示例 |
|---|---|---|---|
name | 是 | 技能唯一标识符 | eterdis-your-skill-name |
description | 是 | 一段式描述,说明技能用途和触发场景 | 详见 SKILL-TEMPLATE.md |
homepage | 否 | 技能文档主页 URL | https://eterdis.com/skills/... |
描述编写原则:
- 明确说明 AI 代理何时应使用此技能
- 描述触发技能的问题或情境类型
- 保持具体,避免泛泛而谈
三模式运行机制
技能支持三种运行模式,统一入口设计确保用户体验的一致性。
模式概览
| 模式 | 用途 | 预计时长 | 触发条件 |
|---|---|---|---|
| Diagnostic | 首次深度会话 | 30-60 分钟 | 无历史记录或计划有重大变更 |
| Review | 周期性重新评估 | 15-20 分钟 | 存在历史记录且计划未大幅变化 |
| Alert Triggers | 预警监控设置 | 10-15 分钟 | 设置或检查预警信号 |
模式选择流程
graph TD
A[开始] --> B{company-context.md<br/>存在历史记录?}
B -->|是| C{上次分析类型?}
B -->|否| D[Diagnostic 模式]
C -->|预演分析| E{计划有重大变更?}
C -->|其他类型| F{Review 模式<br/>还是 Alert Triggers?}
E -->|否| G[Review 模式]
E -->|是| D
F --> H[选择模式]
D --> I[执行完整会话]
G --> J[检查进展]
H --> K[执行选定模式]资料来源:strategy-diagnostic/SKILL.md:35-50
上下文加载机制
company-context.md 交互规范
技能通过读取和更新共享的 company-context.md 文件实现跨会话状态持久化。
加载逻辑:
- 技能启动时检查
company-context.md是否存在 - 若存在,读取相关章节并生成开场反思
- 若不存在,通过开场问题引导用户建立初始上下文
开场反思格式示例:
"I've read through your materials. Here's what stands out to me: [2-3 observations — tensions, gaps, or things that don't quite add up]. Before we start, tell me — does that match where the most important questions are, or am I looking at the wrong thing?"
开场问题模板:
- 这个技能涉及什么业务或问题?
- 谁是最终用户或客户?
- 核心交付物是什么——如果你们消失,他们会想念什么?
- 您心中的战略问题是什么——成本结构、竞争定位、构建vs购买,还是其他?
资料来源:strategy-diagnostic/SKILL.md:20-35
上下文文件结构
# Company Context
## Organisation
- Name: [组织名称]
- Industry: [行业]
- Size: [规模]
## What pays the bills
[商业模式描述]
## Resources that matter
[VRIO 资源表]
## Session log
[会话历史记录]
阶段设计规范
阶段结构模板
每个技能应包含 2-4 个主要阶段(Phase),每个阶段遵循统一结构:
| 组成部分 | 说明 |
|---|---|
| 阶段名称 | 简洁的标题,概括阶段目的 |
| 目标描述 | 该阶段要实现什么 |
| 问题列表 | 引导性问题,驱动对话 |
| 倾听要点 | 需要关注的信号类型 |
| 方向指示 | 不同回答如何影响后续流程 |
阶段示例结构
## [阶段名称]
[描述该阶段的目的和范围]
### 提问
- [主要开场问题]
- [跟进问题 1]
- [跟进问题 2]
### 倾听要点
- 用户首先提到什么(优先级信号)
- 用户刻意跳过什么(盲点信号)
- 用户如何组织叙述(思维模式信号)
### 后续路径
- 若 [信号 A] → 进入 [阶段/方向]
- 若 [信号 B] → 深入探索 [主题]
模式与信号表格
模式与信号(Patterns and Red Flags)部分帮助实践者识别常见情况并采取适当行动。
表格格式规范
| 信号 | 含义 | 探测方式 |
|---|---|---|
| [可观察现象] | [潜在问题] | [跟进问题或方法] |
| ... | ... | ... |
设计原则
- 可观察性 — 表格中的信号应是外部可观察的行为或陈述
- 可操作性 — 每种信号应关联具体的下一步行动
- 非排他性 — 同一现象可能对应多种解释,需结合上下文判断
综合输出规范
当对话达到自然停止点时,技能应产出标准化综合输出。
输出结构
## Synthesis
When the conversation reaches a natural stopping point, produce:
1. **[输出组件 1]** — [内容说明]
2. **[输出组件 2]** — [内容说明]
3. **Key questions that remain open** — [待解决的问题]
Present the synthesis to the user and ask: "What's missing? What did I get wrong?"
会话状态维护
技能应在内部维护运行状态,不向用户展示但指导决策:
## Internal State
Maintain a running diagnostic state throughout the conversation:
DIAGNOSTIC STATE ================ Organisation: [name, industry, size when known] Presenting issue: [what they said first] Emerging issue: [what you think is actually going on]
SIGNALS DETECTED:
- [signal] → suggests [framework]
CONTRADICTIONS:
- [they said X about topic A, but Y about topic B]
KEY FINDINGS:
- [finding]
- [finding]
OPEN QUESTIONS:
- [what you still don't know]
资料来源:strategy-diagnostic/SKILL.md:12-30
边界定义
每个技能必须明确声明其覆盖范围之外的内容。
边界部分格式
## Boundaries
This skill does NOT cover:
- [明确排除的内容]
- [相邻但属于其他技能的主题]
If [特定信号], suggest switching to [其他技能名称].
边界设计原则
- 避免技能功能重叠导致的混乱
- 为用户推荐更合适的技能路径
- 保持技能职责单一性
创建新技能指南
开发流程
graph TD
A[从 SKILL-TEMPLATE.md 开始] --> B[定义技能名称和描述]
B --> C[设计模式选择流程]
C --> D[构建阶段结构]
D --> E[定义模式与信号表格]
E --> F[设计综合输出格式]
F --> G[明确边界定义]
G --> H[测试对话流程]
H --> I{通过测试?}
I -->|否| D
I -->|是| J[发布技能]命名规范
技能命名格式:eterdis-[skill-name]
示例:eterdis-wardley-map、eterdis-first-principles
文件位置
- 独立技能:
/[skill-name]/SKILL.md - 安装包:
install/skills/[skill-name].md
必需章节检查清单
- [ ] YAML frontmatter(name、description、homepage)
- [ ] 上下文加载说明
- [ ] 模式选择逻辑
- [ ] Diagnostic 模式完整流程
- [ ] Review 模式流程(可选)
- [ ] Alert Triggers 模式(可选)
- [ ] Patterns and Red Flags 表格
- [ ] Synthesis 输出规范
- [ ] Boundaries 边界定义
- [ ] company-context.md 更新说明
最佳实践
提问设计
- 单一入口原则 — 每阶段以一个核心问题开场,避免问卷式提问
- 沉默引导 — 提出问题后停止说话,让用户充分表达
- 跟进策略 — 基于用户回答选择性使用 2-3 个跟进问题
对话节奏
| 阶段 | 建议时长 | 节奏控制 |
|---|---|---|
| 开场 | 5-10 分钟 | 广泛倾听,不急于框架 |
| 深入 | 20-40 分钟 | 聚焦发现,验证假设 |
| 综合 | 5-10 分钟 | 梳理输出,确认遗漏 |
矛盾处理
当用户陈述出现矛盾时:
- 内部记录矛盾点
- 在后续对话中温和验证
- 在 Synthesis 中明确指出
- 询问用户哪个理解是正确的
与其他技能的关系
技能库中的技能相互关联,形成战略分析工具链:
graph LR
A[entry] --> B[strategy-diagnostic<br/>诊断入口]
B --> C[strategy-map<br/>因果链分析]
B --> D[wardley-map<br/>演进图谱]
B --> E[vrio-analysis<br/>竞争优势]
B --> F[first-principles<br/>第一性原理]
B --> G[environmental-radar<br/>外部环境]
B --> H[market-position<br/>市场定位]
C --> I[pre-mortem<br/>预演分析]
D --> I
I --> J[protoloop<br/>创新保护]技能协作示例:
strategy-diagnostic作为入口,检测应使用哪个框架wardley-map分析组件演进阶段,指导战略选择vrio-analysis验证竞争优势的可持续性pre-mortem压力测试选定的战略方向
资料来源:README.md:25-40
扩展阅读
- Agent Skills 规范 — SKILL.md 格式官方文档
- Wardley Maps — 演进图谱理论创始人 Simon Wardley
- VRIO Framework — Jay Barney 1991 年提出的资源分析框架
资料来源:README.md:1-15
贡献指南
本文档介绍如何为 strategy-skills 项目做出贡献。该项目是一组开源的战略框架,以 AI 引导的对话形式运行。贡献者可以通过提交新的技能(Skills)、改进现有技能或修复问题来参与项目。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
继续阅读本节完整说明和来源证据。
项目概述
项目定位
strategy-skills 是一个基于 20 年咨询实践经验开发的开源策略框架集合。这些技能以结构化提示词的形式存在,可将任何大型语言模型转变为战略思维伙伴。资料来源:README.md:1-9
核心特性
| 特性 | 说明 |
|---|---|
| 模型无关性 | 支持 Claude、ChatGPT、Gemini 及任何可读取 Markdown 的模型 |
| 三种运行模式 | Diagnostic(诊断)、Review(审查)、Alert Triggers(预警触发) |
| 共享上下文 | 所有技能读写共享的 company-context.md 文件 |
| 免费开源 | 基于咨询实践积累,免费提供给社区使用 |
贡献范围
可贡献的内容
根据项目性质,贡献主要涵盖以下领域:
- 新技能开发 — 创建符合 SKILL.md 格式的新战略框架技能
- 现有技能改进 — 优化问题设计、改进流程、增强诊断能力
- 文档完善 — 补充示例、修正说明、优化可读性
- 代码增强 — MCP 服务器功能扩展、工具脚本开发
技能模板规范
所有技能必须遵循 SKILL-TEMPLATE.md 定义的统一格式。模板核心结构如下:
来源:https://github.com/eterdis/strategy-skills / 项目说明书
失败模式与踩坑日记
保留 Doramagic 在发现、验证和编译中沉淀的项目专属风险,不把社区讨论只当作装饰信息。
用户照着仓库名搜索包或照着包名找仓库时容易走错入口。
假设不成立时,用户拿不到承诺的能力。
新项目、停更项目和活跃项目会被混在一起,推荐信任度下降。
下游已经要求复核,不能在页面中弱化。
Pitfall Log / 踩坑日志
项目:eterdis/strategy-skills
摘要:发现 7 个潜在踩坑项,其中 0 个为 high/blocking;最高优先级:身份坑 - 仓库名和安装名不一致。
1. 身份坑 · 仓库名和安装名不一致
- 严重度:medium
- 证据强度:runtime_trace
- 发现:仓库名
strategy-skills与安装入口skills不完全一致。 - 对用户的影响:用户照着仓库名搜索包或照着包名找仓库时容易走错入口。
- 建议检查:在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。
- 复现命令:
npx skills - 防护动作:页面必须同时展示 repo 名和真实安装入口,避免用户搜索错包。
- 证据:identity.distribution | mcp_registry:io.github.eterdis/strategy-skills:1.0.1 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.eterdis%2Fstrategy-skills/versions/1.0.1 | repo=strategy-skills; install=skills
2. 能力坑 · 能力判断依赖假设
- 严重度:medium
- 证据强度:source_linked
- 发现:README/documentation is current enough for a first validation pass.
- 对用户的影响:假设不成立时,用户拿不到承诺的能力。
- 建议检查:将假设转成下游验证清单。
- 防护动作:假设必须转成验证项;没有验证结果前不能写成事实。
- 证据:capability.assumptions | mcp_registry:io.github.eterdis/strategy-skills:1.0.1 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.eterdis%2Fstrategy-skills/versions/1.0.1 | README/documentation is current enough for a first validation pass.
3. 维护坑 · 维护活跃度未知
- 严重度:medium
- 证据强度:source_linked
- 发现:未记录 last_activity_observed。
- 对用户的影响:新项目、停更项目和活跃项目会被混在一起,推荐信任度下降。
- 建议检查:补 GitHub 最近 commit、release、issue/PR 响应信号。
- 防护动作:维护活跃度未知时,推荐强度不能标为高信任。
- 证据:evidence.maintainer_signals | mcp_registry:io.github.eterdis/strategy-skills:1.0.1 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.eterdis%2Fstrategy-skills/versions/1.0.1 | last_activity_observed missing
4. 安全/权限坑 · 下游验证发现风险项
- 严重度:medium
- 证据强度:source_linked
- 发现:no_demo
- 对用户的影响:下游已经要求复核,不能在页面中弱化。
- 建议检查:进入安全/权限治理复核队列。
- 防护动作:下游风险存在时必须保持 review/recommendation 降级。
- 证据:downstream_validation.risk_items | mcp_registry:io.github.eterdis/strategy-skills:1.0.1 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.eterdis%2Fstrategy-skills/versions/1.0.1 | no_demo; severity=medium
5. 安全/权限坑 · 存在评分风险
- 严重度:medium
- 证据强度:source_linked
- 发现:no_demo
- 对用户的影响:风险会影响是否适合普通用户安装。
- 建议检查:把风险写入边界卡,并确认是否需要人工复核。
- 防护动作:评分风险必须进入边界卡,不能只作为内部分数。
- 证据:risks.scoring_risks | mcp_registry:io.github.eterdis/strategy-skills:1.0.1 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.eterdis%2Fstrategy-skills/versions/1.0.1 | no_demo; severity=medium
6. 维护坑 · issue/PR 响应质量未知
- 严重度:low
- 证据强度:source_linked
- 发现:issue_or_pr_quality=unknown。
- 对用户的影响:用户无法判断遇到问题后是否有人维护。
- 建议检查:抽样最近 issue/PR,判断是否长期无人处理。
- 防护动作:issue/PR 响应未知时,必须提示维护风险。
- 证据:evidence.maintainer_signals | mcp_registry:io.github.eterdis/strategy-skills:1.0.1 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.eterdis%2Fstrategy-skills/versions/1.0.1 | issue_or_pr_quality=unknown
7. 维护坑 · 发布节奏不明确
- 严重度:low
- 证据强度:source_linked
- 发现:release_recency=unknown。
- 对用户的影响:安装命令和文档可能落后于代码,用户踩坑概率升高。
- 建议检查:确认最近 release/tag 和 README 安装命令是否一致。
- 防护动作:发布节奏未知或过期时,安装说明必须标注可能漂移。
- 证据:evidence.maintainer_signals | mcp_registry:io.github.eterdis/strategy-skills:1.0.1 | https://registry.modelcontextprotocol.io/v0.1/servers/io.github.eterdis%2Fstrategy-skills/versions/1.0.1 | release_recency=unknown
来源:Doramagic 发现、验证与编译记录