# https://github.com/eterdis/strategy-skills 项目说明书
生成时间：2026-05-31 17:23:21 UTC
## 目录
- [项目介绍](#page-intro)
- [快速开始](#page-quickstart)
- [系统架构](#page-architecture)
- [MCP 服务器集成](#page-mcp-server)
- [技能目录](#page-skills-catalog)
- [诊断类技能](#page-diagnostic-skills)
- [决策与构建类技能](#page-strategy-skills)
- [上下文管理](#page-context-management)
- [技能开发模板](#page-skill-template)
- [贡献指南](#page-contributing)
## 项目介绍
### 相关页面
相关主题：[快速开始](#page-quickstart), [系统架构](#page-architecture)
相关源码文件
以下源码文件用于生成本页说明：
- [README.md](https://github.com/eterdis/strategy-skills/blob/main/README.md)
- [SKILL-TEMPLATE.md](https://github.com/eterdis/strategy-skills/blob/main/SKILL-TEMPLATE.md)
- [strategy-diagnostic/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/strategy-diagnostic/SKILL.md)
- [wardley-map/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/wardley-map/SKILL.md)
- [first-principles-strategy/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/first-principles-strategy/SKILL.md)
- [pre-mortem/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/pre-mortem/SKILL.md)
- [vrio-analysis/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/vrio-analysis/SKILL.md)
- [protoloop-setup/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/protoloop-setup/SKILL.md)
- [install/company-context.md](https://github.com/eterdis/strategy-skills/blob/main/install/company-context.md)
# 项目介绍
## 项目概述
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]()
```mermaid
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]()
## 架构组件
### 技能文件结构
每个技能目录下包含核心文件：
```mermaid
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]()
```mermaid
graph TD
A[Phase 1: Landscape
理解现状] --> B[Phase 2: Framework
选择框架]
B --> C[Phase 3: Synthesis
综合分析]
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 的演进
```mermaid
graph LR
A[Genesis
创世] --> B[Custom-built
定制]
B --> C[Product
产品]
C --> D[Commodity
商品化]
```
### 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]()
```mermaid
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]()
```json
{
"name": "@eterdis/strategy-skills-mcp",
"version": "1.0.0",
"dependencies": {
"@modelcontextprotocol/sdk": "^1.29.0",
"zod": "^3.25.0"
}
}
```
## 使用指南
### 首次使用流程
1. 阅读 `company-context.md` 文件了解现有上下文
2. 选择合适的入口技能（推荐 `strategy-diagnostic`）
3. 根据提示选择运行模式（诊断/回顾/预警）
4. 完成会话后，技能会自动更新 `company-context.md`
5. 在后续会话中引用更新后的上下文
### 上下文更新机制
每个技能在完成诊断后都会更新 `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 文件。
---
## 快速开始
### 相关页面
相关主题：[项目介绍](#page-intro), [系统架构](#page-architecture)
相关源码文件
以下源码文件用于生成本页说明：
- [README.md](https://github.com/eterdis/strategy-skills/blob/main/README.md)
- [install/company-context.md](https://github.com/eterdis/strategy-skills/blob/main/install/company-context.md)
- [strategy-diagnostic/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/strategy-diagnostic/SKILL.md)
- [wardley-map/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/wardley-map/SKILL.md)
- [vrio-analysis/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/vrio-analysis/SKILL.md)
- [pre-mortem/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/pre-mortem/SKILL.md)
# 快速开始
本文档为 eterdis/strategy-skills 项目的新用户提供全面的入门指南，帮助您快速了解、安装并开始使用策略技能框架。
## 项目概述
### 什么是策略技能
策略技能（Strategy Skills）是一套结构化提示模板，采用 [SKILL.md 格式](https://agentskills.io)，用于引导大语言模型（LLM）执行经过验证的战略框架。这些技能帮助 LLM 提出正确的问题、发现模式、揭示矛盾并产出可操作的输出。
```mermaid
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/` 目录：
```json
// 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` 文件来维护跨会话的战略情报：
```mermaid
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 资源表结构
```markdown
| Resource | Type | VRIO status | Last validated |
|----------|------|-------------|----------------|
| [资源名] | [类型] | [状态] | [日期] |
```
### 竞争格局表结构
```markdown
| 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：确定运行模式
根据您的需求选择合适的模式：
```mermaid
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`：
```markdown
## 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: 多久需要更新一次上下文？
建议季度回顾，但关键信息（如核心策略变化、重大组织调整）应立即更新。
## 下一步
1. **深入阅读**：选择感兴趣的技能，详细阅读其 SKILL.md 文件
2. **创建上下文**：基于 `company-context.md` 模板创建您自己的上下文文件
3. **运行诊断**：使用 `strategy-diagnostic` 开始您的第一次会话
4. **探索 Wardley 映射**：学习如何创建业务格局地图
---
## 系统架构
### 相关页面
相关主题：[MCP 服务器集成](#page-mcp-server), [上下文管理](#page-context-management)
相关源码文件
以下源码文件用于生成本页说明：
- [SKILL-TEMPLATE.md](https://github.com/eterdis/strategy-skills/blob/main/SKILL-TEMPLATE.md)
- [README.md](https://github.com/eterdis/strategy-skills/blob/main/README.md)
- [strategy-diagnostic/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/strategy-diagnostic/SKILL.md)
- [install/skills/wardley-map.md](https://github.com/eterdis/strategy-skills/blob/main/install/skills/wardley-map.md)
- [install/skills/vrio.md](https://github.com/eterdis/strategy-skills/blob/main/install/skills/vrio.md)
- [install/skills/pre-mortem.md](https://github.com/eterdis/strategy-skills/blob/main/install/skills/pre-mortem.md)
- [install/skills/first-principles.md](https://github.com/eterdis/strategy-skills/blob/main/install/skills/first-principles.md)
- [install/skills/protoloop.md](https://github.com/eterdis/strategy-skills/blob/main/install/skills/protoloop.md)
- [install/company-context.md](https://github.com/eterdis/strategy-skills/blob/main/install/company-context.md)
- [mcp-server/package.json](https://github.com/eterdis/strategy-skills/blob/main/mcp-server/package.json)
# 系统架构
## 1. 项目概述
策略技能（Strategy Skills）是一个开源的AI引导战略框架系统，设计用于将任何大型语言模型转变为战略思维伙伴。该项目基于20年的咨询实践经验开发，完全免费、开放且模型无关 资料来源：[README.md:1-3]()。
系统的核心设计理念是将复杂的战略分析方法论封装为结构化的技能（Skill），每个技能都是一个独立的Markdown文件，通过标准化的格式引导AI进行战略分析与决策支持。
## 2. 整体架构
### 2.1 架构分层模型
策略技能系统采用三层架构设计，各层之间通过标准化的接口进行通信：
```mermaid
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 --> M
```
### 2.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]()：
```mermaid
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 技能通用结构
每个技能文件包含以下标准化部分：
```markdown
# 技能标题
## 加载公司上下文
- 检查company-context.md是否存在
- 读取相关上下文信息
- 根据上下文决定开场方式
## 确定模式
- 诊断模式条件判断
- 回顾模式条件判断
- 预警模式条件判断
## 阶段1: [阶段名称]
- 实施步骤
- 提问问题
- 期望响应
## 阶段2: [阶段名称]
- ...
## 模式N: [模式名称]
## 综合输出
- 输出组件1
- 输出组件2
- 待解决问题
## 边界
- 明确不覆盖的范围
- 建议转接的技能
```
## 4. 数据管理架构
### 4.1 公司上下文文件结构
公司上下文文件（company-context.md）是跨会话累积战略情报的核心数据存储 资料来源：[install/company-context.md:1-60]()：
```mermaid
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 上下文更新流程
```mermaid
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]()。
诊断状态在会话期间持续维护，指导探测决策和框架调用：
```markdown
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]()：
```mermaid
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]()：
```mermaid
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]()：
```json
{
"dependencies": {
"@modelcontextprotocol/sdk": "^1.29.0",
"zod": "^3.25.0"
}
}
```
MCP服务器采用TypeScript开发，提供类型安全的消息传递和工具调用能力。
### 6.2 技能安装结构
```mermaid
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 技能协作网络
```mermaid
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 -.-> CC
```
### 7.2 技能边界定义
系统通过明确的边界定义避免技能间的冲突和重复 资料来源：[SKILL-TEMPLATE.md:60-70]()：
| 技能 | 覆盖范围 | 明确排除 |
|------|---------|---------|
| 战略诊断 | 整体评估入口 | 具体分析方法 |
| Wardley地图 | 业务环境地图 | 资源能力分析 |
| VRIO分析 | 资源竞争价值 | 市场定位 |
| 预演分析 | 风险识别 | 环境扫描 |
## 8. 工作流程示例
### 8.1 完整诊断工作流
```mermaid
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]()：
1. 读取现有上下文文件
2. 验证上次发现是否仍然有效
3. 识别自上次会话以来的变化
4. 更新关键发现
5. 设置新的预警触发器
## 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 技能加载流程
技能可通过两种方式加载：
1. **直接读取**：AI直接读取Markdown文件并按结构执行
2. **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 | 技能名称 | 发现描述 | 决策内容 | 日期 |
---
## MCP 服务器集成
### 相关页面
相关主题：[系统架构](#page-architecture), [项目介绍](#page-intro)
相关源码文件
以下源码文件用于生成本页说明：
- [mcp-server/package.json](https://github.com/eterdis/strategy-skills/blob/main/mcp-server/package.json)
- [strategy-diagnostic/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/strategy-diagnostic/SKILL.md)
- [wardley-map/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/wardley-map/SKILL.md)
- [strategy-map/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/strategy-map/SKILL.md)
- [first-principles-strategy/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/first-principles-strategy/SKILL.md)
- [pre-mortem/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/pre-mortem/SKILL.md)
- [install/company-context.md](https://github.com/eterdis/strategy-skills/blob/main/install/company-context.md)
# MCP 服务器集成
## 概述
MCP 服务器集成是 strategy-skills 项目的核心组件，它将 11 个开放战略框架通过 Model Context Protocol (MCP) 协议暴露为 AI 引导提示。该服务器基于 20 年咨询实践构建，采用 CC-BY-4.0 开源许可证，完全模型无关。
资料来源：[mcp-server/package.json:4]()
```mermaid
graph TB
subgraph MCP生态系统
A[AI 客户端
Claude/ChatGPT/Gemini] --> B[MCP 协议层]
B --> C[@eterdis/strategy-skills-mcp]
C --> D[策略框架集合]
D --> E[company-context.md
共享上下文]
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]()
### 发布文件配置
```json
{
"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]()
### 通用运行模式
```mermaid
stateDiagram-v2
[*] --> 诊断模式: 首次使用/计划变更
诊断模式 --> 审查模式: 已有发现/定期重评
审查模式 --> 警报触发模式: 设置监控条件
警报触发模式 --> 审查模式: 触发条件满足
审查模式 --> 诊断模式: 重大变更
```
所有框架支持三种运行模式：
- **诊断模式** — 深入首次使用会话（30-60 分钟）
- **审查模式** — 周期性重新评估（15-20 分钟）
- **警报触发模式** — 设置早期预警监控条件
资料来源：[strategy-diagnostic/SKILL.md:50-80]()
## 共享上下文机制
### company-context.md 角色
所有策略框架读写共享的 `company-context.md` 文件，该文件跨会话累积战略情报：
```mermaid
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 工作流
```mermaid
graph TD
A[Phase 1: Landscape
5-10 分钟] --> B{检测信号}
B -->|2-3 个框架| C[Phase 2: Probing
15-25 分钟]
B -->|信号明确| D[直接调用框架]
C --> E[Phase 3: Synthesis
输出发现]
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 工作流
```mermaid
graph TD
A[Phase 1: Anchor
用户需求锚定] --> B[Phase 2: Value Chain
依赖链构建]
B --> C[Phase 3: Evolution
演化轴定位]
C --> D[Phase 4: Strategic Plays
战略玩法识别]
D --> E[输出地图到上下文]
```
资料来源：[wardley-map/SKILL.md:30-60]()
### First Principles 工作流
```mermaid
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 工作流
在计划执行前进行压力测试：
1. 设想计划已经失败
2. 逆向推导失败原因
3. 识别主动假设
4. 进行猴子测试（如果计划失败，谁会首先注意到？）
资料来源：[pre-mortem/SKILL.md:1-30]()
## 关键词与分类
| 分类 | 关键词 |
|------|--------|
| 协议 | mcp, model-context-protocol |
| 领域 | strategy, consulting, ai-agent, frameworks |
| 分析方法 | vrio, wardley-map, playing-to-win |
| 平台 | claude, chatgpt, gemini |
资料来源：[mcp-server/package.json:19-22]()
## 快速开始
### 安装依赖
```bash
cd mcp-server
npm install
```
### 构建项目
```bash
npm run build
```
### 使用 MCP 客户端
配置 MCP 客户端连接至 `eterdis-strategy-skills-mcp` 服务即可开始使用策略框架。
## 扩展机制
项目设计支持扩展新框架：
1. 在 `content/` 目录创建新的 `SKILL.md` 文件
2. 遵循 SKILL.md 格式规范
3. 更新 MCP 服务器以注册新工具
4. 在 `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 |
---
## 技能目录
### 相关页面
相关主题：[诊断类技能](#page-diagnostic-skills), [决策与构建类技能](#page-strategy-skills)
相关源码文件
以下源码文件用于生成本页说明：
- [README.md](https://github.com/eterdis/strategy-skills/blob/main/README.md)
- [SKILL-TEMPLATE.md](https://github.com/eterdis/strategy-skills/blob/main/SKILL-TEMPLATE.md)
- [strategy-diagnostic/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/strategy-diagnostic/SKILL.md)
- [wardley-map/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/wardley-map/SKILL.md)
- [vrio-analysis/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/vrio-analysis/SKILL.md)
- [pre-mortem/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/pre-mortem/SKILL.md)
- [first-principles-strategy/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/first-principles-strategy/SKILL.md)
- [protoloop-setup/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/protoloop-setup/SKILL.md)
# 技能目录
## 概述
技能目录（Skills）是 Eterdis Strategy Skills 项目的核心组件，定义了九个战略框架技能，用于将任何大型语言模型转变为战略思维伙伴。每个技能都是一个独立的 Markdown 文件，采用 [Agent Skills 格式](https://agentskills.io)，引导用户完成经过验证的战略方法论。
这些技能基于 20 年咨询实践经验开发，完全免费、开源且模型无关，可与 Claude、ChatGPT、Gemini 或任何支持 Markdown 的模型配合使用。
资料来源：[README.md:1-15]()
## 技能架构
### 整体分类
项目中的技能按照战略分析的不同维度进行组织，分为四个主要类别：
| 类别 | 技能名称 | 用途定位 |
|------|----------|----------|
| 入口与诊断 | strategy-diagnostic | 战略评估入口点，检测应运行哪个框架 |
| 因果与演进 | strategy-map、wardley-map | 资源到结果的因果链映射 |
| 资源与优势 | vrio-analysis | 测试竞争优势的真实性与持久性 |
| 外部与内部 | environmental-radar、market-position | 内外部环境扫描与定位 |
### 技能关系图
```mermaid
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 地图是一种商业景观地图，包含两个轴：
```mermaid
graph LR
subgraph 垂直轴-价值链
UN[用户需求]
CA[组件A]
CB[组件B]
CC[组件C]
end
subgraph 水平轴-演进
G[Genesis
创世]
C[Custom
定制]
P[Product
产品]
CO[Commodity
商品化]
end
UN --> CA
CA --> CB
CB --> CC
```
**核心阶段定义：**
| 阶段 | 名称 | 特征 |
|------|------|------|
| Stage 1 | Genesis（创世） | 全新、实验性、未知结果 |
| Stage 2 | Custom（定制） | 定制开发、独特解决方案 |
| Stage 3 | Product（产品） | 可购买、市场存在 |
| Stage 4 | Commodity（商品化） | 基础设施、实用程序 |
Wardley 地图的构建分为三个主要阶段：
1. **锚定** — 从用户需求出发，而非产品或技术
2. **价值链** — 识别组件依赖关系
3. **演进轴** — 确定每个组件在进化曲线上的位置
资料来源：[wardley-map/SKILL.md:1-80]()
## 资源分析技能
### VRIO 分析（vrio-analysis）
**文件路径：** `vrio-analysis/SKILL.md`
VRIO 分析（Jay Barney, 1991）用于评估企业资源和能力的竞争优势。该框架提出四个关键问题：
```mermaid
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 分析涵盖：
- **P**olitical（政治）
- **E**conomic（经济）
- **S**ocial（社会）
- **T**echnological（技术）
- **E**nvironmental（环境）
- **L**egal（法律）
资料来源：[README.md:25]()
### 市场定位（market-position）
市场定位技能分析企业在竞争格局中的实际位置，而非幻灯片上声称的位置。该技能帮助回答：
- 目标客户实际如何认知你的产品？
- 你的真实差异化因素是什么？
- 竞争对手对你的看法与你自己有何不同？
资料来源：[README.md:26]()
## 决策支持技能
### 事前分析（pre-mortem）
**文件路径：** `pre-mortem/SKILL.md`
事前分析是一种前瞻性风险识别技术，在计划实施前预演可能的失败。该技能支持三种模式：
| 模式 | 说明 |
|------|------|
| 诊断模式 | 首次进行全面分析 |
| 回顾模式 | 检查失败因素是否已改变 |
| 预警触发器模式 | 定义早期预警信号 |
**核心分析要素：**
1. 识别活跃假设
2. 预演失败场景
3. 设计应对措施
4. 更新公司上下文文档
资料来源：[pre-mortem/SKILL.md:1-50]()
### 第一性原理策略（first-principles-strategy）
**文件路径：** `first-principles-strategy/SKILL.md`
第一性原理策略用于打破传统假设，重新审视约束条件。该技能区分两类约束：
| 约束类型 | 定义 | 示例 |
|----------|------|------|
| 物理约束 | 宇宙不允许违反的自然法则 | 光速、热力学 |
| 传统约束 | 约定俗成的做事方式 | 行业惯例、历史做法 |
该技能引导用户通过六个阶段：
1. 定义理论最大值
2. 识别当前差距
3. 分析阻碍因素
4. 质疑假设
5. 设计新路径
6. 反推至当前行动
资料来源：[first-principles-strategy/SKILL.md:1-60]()
## 创新机制技能
### 原型循环（protoloop-setup）
**文件路径：** `protoloop-setup/SKILL.md`
原型循环技能帮助组织建立持续创新机制，核心概念包括：
**双轨模型：**
```mermaid
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 分钟
### 预警触发器模式
- **触发条件：** 设定或检查监控条件
- **执行内容：** 定义或验证早期预警信号
- **时间预期：** 按需
```mermaid
stateDiagram-v2
[*] --> 诊断模式: 首次运行
诊断模式 --> 回顾模式: 完成首次分析
回顾模式 --> 诊断模式: 重大变化发生
诊断模式 --> 预警触发器: 设定监控
回顾模式 --> 预警触发器: 更新触发条件
预警触发器 --> 诊断模式: 触发条件满足
```
资料来源：[strategy-diagnostic/SKILL.md:15-30]()
## 技能模板结构
每个技能文件遵循统一的 SKILL.md 格式：
| 区域 | 内容 |
|------|------|
| 元数据 | 名称、描述、主页链接 |
| 上下文加载 | 如何读取和使用 company-context.md |
| 技能介绍 | 工具用途、使用场景、解决的问题 |
| 阶段/步骤 | 具体执行步骤和提问方式 |
| 模式选择 | 三种模式的切换逻辑 |
| 边界定义 | 技能不覆盖的范围 |
| 输出格式 | 合成结果的呈现方式 |
资料来源：[SKILL-TEMPLATE.md:1-80]()
## 最佳实践
### 技能选择流程
```mermaid
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`，包括：
1. 新发现的关键信息
2. 更新的评估结论
3. 下次审查的待办事项
4. 会话日志条目
资料来源：[install/company-context.md:45-50]()
## 扩展与定制
### 添加新技能
要添加新技能，需遵循模板结构：
1. 创建新目录，如 `new-skill/`
2. 创建 `SKILL.md` 文件
3. 在 README.md 的技能表中添加条目
4. 定义技能的触发条件和边界
### 技能本地化
所有技能文件采用 Markdown 格式，支持：
- 翻译为其他语言
- 调整提问措辞
- 添加组织特定场景
## 总结
技能目录构成了 Eterdis Strategy Skills 的核心框架体系，提供从战略诊断到创新机制的全方位战略思维支持。通过标准化的 SKILL.md 格式和共享的上下文机制，这些技能能够协作运行，帮助组织进行系统化战略思考。
各技能之间的关系可概括为：
- **诊断技能** 识别问题类型
- **映射技能** 理解因果结构
- **分析技能** 评估资源和位置
- **决策技能** 预演风险和可能性
- **创新技能** 推动持续变革
---
## 诊断类技能
### 相关页面
相关主题：[技能目录](#page-skills-catalog), [决策与构建类技能](#page-strategy-skills)
相关源码文件
以下源码文件用于生成本页说明：
- [strategy-diagnostic/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/strategy-diagnostic/SKILL.md)
- [strategy-map/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/strategy-map/SKILL.md)
- [vrio-analysis/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/vrio-analysis/SKILL.md)
- [environmental-radar/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/environmental-radar/SKILL.md)
- [market-position/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/market-position/SKILL.md)
- [wardley-map/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/wardley-map/SKILL.md)
- [culture-assessment/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/culture-assessment/SKILL.md)
# 诊断类技能
## 概述
诊断类技能是策略技能库中的核心入口模块，设计用于通过 AI 引导的对话方式执行战略评估与诊断。这类技能遵循统一的 SKILL.md 格式规范，能够与任何支持 Markdown 的大型语言模型配合工作，将模型转变为战略思维伙伴。
诊断类技能的核心价值在于**探测与定位**——通过结构化的提问、模式识别和矛盾检测，帮助用户识别当前战略环境中的关键问题，并决定下一步应该调用哪些具体的分析框架。资料来源：[strategy-diagnostic/SKILL.md]()
## 技能架构
诊断类技能库采用分层架构设计：
```mermaid
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）
市场定位技能分析组织的实际竞争位置，而非管理层设想的位置。该技能通过系统性对比揭示真实的市场地位：
```mermaid
graph LR
A[自身定位] --> B{是否存在差距?}
B -->|是| C[实际定位分析]
B -->|否| D[保持现状监控]
C --> E[竞争策略调整]
D --> F[定期复核]
```
资料来源：[market-position/SKILL.md]()
### 沃德利地图技能（wardley-map）
沃德利地图技能绘制组织的业务景观图，包含两个核心维度：
| 维度 | 含义 |
|------|------|
| **纵轴：价值链** | 从用户需求向下追溯至基础设施 |
| **横轴：进化阶段** | 组件从Genesis→Custom Built→Product→Commodity的演进 |
进化阶段的定义：
| 阶段 | 特征 | 示例 |
|------|------|------|
| Genesis | 全新实验，尚未验证 | 1880年的电力应用 |
| Custom Built | 定制解决方案 | 早期工厂发电系统 |
| Product | 可购买的产品 | 发电机 |
| Commodity | 标准化公用事业 | 电网供电 |
资料来源：[wardley-map/SKILL.md]()
### 战略映射技能（strategy-map）
战略映射技能建立从资源到结果的因果链：
| 映射维度 | 核心问题 |
|----------|----------|
| 期望层 | 利益相关者期望什么？ |
| 要求层 | 满足期望需要什么？ |
| 执行层 | 如何交付这些要求？ |
| 资源层 | 需要哪些资源支撑执行？ |
资料来源：[strategy-map/SKILL.md]()
### 文化评估技能（culture-assessment）
文化评估技能分析组织文化对战略执行的影响，包括文化基因、行为模式和潜在阻力。
资料来源：[culture-assessment/SKILL.md]()
## 与公司上下文的集成
所有诊断类技能共享 `company-context.md` 文件，该文件作为战略信息的中央存储库：
```mermaid
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:#c8e6c9
```
### company-context.md 标准结构
| 章节 | 内容 |
|------|------|
| Organisation | 组织名称、行业、规模、地理位置、所有权 |
| What pays the bills | 当前业务描述 |
| Resources that matter | 3-5 个关键资源/能力 |
| Customers | 真实客户而非目标市场 |
| Competitive landscape | 竞争对手分析表 |
| Current strategy | 一段式策略描述 |
| Financial situation | 收入趋势、利润率、现金流 |
资料来源：[install/company-context.md]()
## 技能选择决策流程
当用户启动诊断时，系统通过以下流程选择合适的技能框架：
```mermaid
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]
```
## 关键设计原则
1. **上下文优先**：优先使用 `company-context.md` 中的现有信息，避免重复构建
2. **信号驱动**：通过检测到的信号动态决定调用哪些框架，而非机械执行全部框架
3. **矛盾标记**：识别并标记用户表述中的矛盾，这些往往是关键洞察的来源
4. **迭代更新**：每次会话后更新上下文文件，确保战略情报的持续积累
5. **模式识别**：识别经验丰富的从业者能够识别的常见模式
资料来源：[strategy-diagnostic/SKILL.md]()
## 使用建议
| 场景 | 推荐模式 | 建议频率 |
|------|----------|----------|
| 首次战略评估 | Diagnostic | 按需 |
| 季度战略复核 | Review | 每季度 |
| 月度快速检查 | Review | 每月 |
| 新威胁/机会出现 | Alert Triggers | 按需 |
| 重大战略变化 | Diagnostic | 按需 |
诊断类技能的设计初衷是让组织能够在有限时间内获得结构化的战略洞察，通过模式化的框架和明确的输出格式，确保诊断结果的可用性和可追溯性。
---
## 决策与构建类技能
### 相关页面
相关主题：[技能目录](#page-skills-catalog), [诊断类技能](#page-diagnostic-skills)
相关源码文件
以下源码文件用于生成本页说明：
- [first-principles-strategy/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/first-principles-strategy/SKILL.md)
- [playing-to-win/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/playing-to-win/SKILL.md)
- [pre-mortem/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/pre-mortem/SKILL.md)
- [protoloop-setup/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/protoloop-setup/SKILL.md)
- [strategy-diagnostic/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/strategy-diagnostic/SKILL.md)
- [SKILL-TEMPLATE.md](https://github.com/eterdis/strategy-skills/blob/main/SKILL-TEMPLATE.md)
- [wardley-map/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/wardley-map/SKILL.md)
# 决策与构建类技能
## 概述
决策与构建类技能是策略技能库中专注于**战略规划、方案构建与风险预判**的核心模块。这套技能帮助用户在复杂商业环境中进行系统性思考，从发现战略问题、构建解决方案到预判失败模式，形成完整的决策支持链条。
与诊断类技能（帮助用户发现"是什么问题"）不同，决策与构建类技能更关注"我们应该如何行动"和"我们的计划会失败吗"。资料来源：[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]()
#### 运作模式
第一性原理策略支持三种运作模式：
```mermaid
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 | 回溯至今 | 制定从当前到目标的行动方案 |
资料来源：[install/skills/first-principles.md:1-30]()
---
### 事前验尸分析（Pre-mortem）
#### 核心概念
事前验尸是一种**逆向思维的风险识别方法**。在计划实施前，假设计划已经失败，然后逆向推理找出可能导致失败的原因。
> 资料来源：[pre-mortem/SKILL.md:1-15]()
#### 运作模式
| 模式 | 触发条件 | 时长 |
|---|---|---|
| Diagnostic | 首次对该计划进行验尸，或计划有重大变更 | 30-45分钟 |
| Review | 已存在验尸发现，需检查失败图景是否改变 | 15-20分钟 |
| Alert Triggers | 定义或检查预警信号 | 10-15分钟 |
资料来源：[pre-mortem/SKILL.md:20-30]()
#### 典型分析维度
```mermaid
graph TD
A[事前验尸分析] --> B[战略假设检验]
A --> C[失败模式识别]
A --> D[策略地图定位]
A --> E[猴子测试]
B --> B1[哪些假设被违反?]
C --> C1[哪些组件会失效?]
C --> C2[失效如何级联?]
D --> D1[在更宏观系统中位置?]
E --> E1[谁会主动破坏计划?]
```
资料来源：[install/skills/pre-mortem.md:1-25]()
#### 关键提问
- 计划已经失败了——它是怎么失败的？
- 哪个假设是错误的？
- 失败模式会如何级联传播？
- 我们的策略地图和沃德利地图中，这个计划处于什么位置？资料来源：[pre-mortem/SKILL.md:25-40]()
---
### 创新回路保护（Protoloop）
#### 核心概念
Protoloop（创新保护回路）是一种**组织设计方法**，旨在保护"第二轨道"创新不被"第一轨道"的日常运营所吞噬。它借鉴免疫系统的隐喻，将主流业务视为"本体"，创新项目视为需要被保护的"异物"。
资料来源：[protoloop-setup/SKILL.md:1-15]()
#### 核心结构
```mermaid
graph TD
A[第二轨道创新] --> B[保护层设计]
A --> C[摄入通道]
A --> D[活跃回路]
B --> D
C --> D
D --> A
E[第一轨道 - 主流业务] -.->|抗体风险| A
E -.->|资源竞争| A
```
#### 关键组件
**摄入通道（Intake Channels）**
| 通道 | 说明 |
|---|---|
| Internal Misfits | 内部"异类"——那些提出非常规想法的人 |
| Technology Scanning | 技术扫描——外部新兴技术信号 |
| External Signals | 外部信号——市场变化、客户反馈 |
| Strategic Overflow | 战略溢出——主战略无法覆盖的机会 |
**活跃回路（Active Loops）**
| 字段 | 用途 |
|---|---|
| Loop name | 回路名称 |
| Question | 要探索的核心问题 |
| Stage | 当前阶段 |
| Time box | 时间盒限制 |
| Forward-loaded next question | 预设下一个问题 |
| Status | 状态 |
| Started | 开始时间 |
资料来源：[protoloop-setup/SKILL.md:30-50]()
#### 运作模式
**Diagnostic 模式**用于首次建立创新保护机制，**Review 模式**为每月一次的心跳会议，每次30分钟。资料来源：[install/skills/protoloop.md:40-60]()
---
### 沃德利地图（Wardley Map）
#### 核心概念
沃德利地图是一种**商业景观可视化工具**，包含两个轴：
- **垂直轴（价值链）**：从用户需求到基础设施的依赖关系
- **水平轴（演进）**：从Genesis（创世）到Commodity/Utility（商品化/公用事业化）的演进阶段
资料来源：[wardley-map/SKILL.md:1-25]()
#### 演进阶段
```mermaid
graph LR
A[Genesis
创世] --> B[Custom Built
定制开发]
B --> C[Product
产品化]
C --> D[Commodity
商品化]
D --> E[Utility
公用事业化]
style A fill:#ff9999
style B fill:#ffcc99
style C fill:#ffff99
style D fill:#99ff99
style E fill:#99ccff
```
| 阶段 | 特征 | 例子 |
|---|---|---|
| Genesis | 全新实验，不可预测 | 1880年的电力 |
| Custom Built | 定制解决方案，供应商依赖 | 早期工厂动力系统 |
| Product | 可购买，但需要选择和集成 | 发电机 |
| Commodity | 标准化，价格竞争 | 电力供应 |
| Utility | 视为理所当然的基础设施 | 电网即插即用 |
资料来源：[install/skills/wardley-map.md:1-30]()
#### 关键阶段
1. **Phase 1: 锚定用户需求** — 从用户的实际需求出发，而非从产品出发
2. **Phase 2: 价值链** — 识别交付用户需求所需的组件及依赖关系
3. **Phase 3: 演进轴定位** — 确定每个组件在演进曲线上的位置
4. **Phase 4: 移动与机会** — 识别正在移动的组件和战略机会
5. **Phase 5: 战略玩法** — 设计具体的战略行动
6. **Phase 6: 预警触发器** — 设置未来需要重新评估的条件
资料来源：[wardley-map/SKILL.md:40-80]()
---
### 制胜策略（Playing to Win）
#### 核心概念
制胜策略框架帮助用户构建**可执行的竞争战略**，将战略选择转化为具体的行动方案。
> 资料来源：[playing-to-win/SKILL.md:1-20]()
#### 使用前提
此技能通常在以下情况下调用：
- 战略诊断已完成，明确了战略问题
- 用户已有初步的战略意向，需要验证和细化
- 需要将抽象的战略意图转化为具体的战略选择
#### 核心问题
| 问题 | 目的 |
|---|---|
| 我们要赢得什么？ | 明确战略目标 |
| 如何取胜？ | 确定制胜方式 |
| 需要什么能力？ | 识别关键资源与能力 |
| 必须做什么？ | 定义关键行动 |
| 障碍是什么？ | 识别潜在风险 |
---
## 决策流程图
整体决策与构建流程如下：
```mermaid
graph TD
A[战略诊断] --> B{是否需要重构假设?}
B -->|是| C[第一性原理分析]
B -->|否| D{是否需要预判风险?}
C --> E[事前验尸分析]
D -->|是| E
D -->|否| F{是否需要保护创新?}
E --> G[沃德利地图定位]
F -->|是| H[创新回路设置]
F -->|否| I{是否需要战略选择?}
G --> J[制胜策略框架]
H --> J
I -->|是| J
J --> K[更新公司上下文]
C -.->|常规约束| L[识别并打破]
D -.->|常规约束| L
```
---
## 上下文管理
所有决策与构建类技能都会更新共享的 `company-context.md` 文件，积累战略情报。资料来源：[install/company-context.md:1-30]()
### 必更新字段
| 字段 | 更新时机 |
|---|---|
| 当前策略 | 策略选择后 |
| 关键假设 | 第一性原理或事前验尸后 |
| 失败模式 | 事前验尸后 |
| 活跃回路 | Protoloop 运行后 |
| 演进位置 | 沃德利地图分析后 |
### 会话日志格式
| 日期 | 运行的技能 | 关键发现 | 采取的行动 | 下次评审时间 |
|---|---|---|---|---|
| YYYY-MM-DD | 技能名称（模式） | 主要发现 | 决定内容 | 日期 |
资料来源：[protoloop-setup/SKILL.md:55-65]()
---
## 边界与注意事项
决策与构建类技能**不涵盖**以下内容：
- 运营优化与流程改进（属于其他技能范畴）
- 具体的技术实现细节
- 财务建模的详细计算
当出现以下信号时，建议切换到其他技能：
| 信号 | 建议切换 |
|---|---|
| 用户关注执行细节而非战略方向 | 切换到运营相关技能 |
| 需要详细的财务预测 | 切换到财务分析技能 |
| 问题是跨部门协调而非战略选择 | 切换到组织设计技能 |
资料来源：[SKILL-TEMPLATE.md:60-75]()
---
## 总结
决策与构建类技能构成了策略技能库的行动层，它们：
1. **从假设到方案** — 通过第一性原理打破常规，构建新路径
2. **从计划到风险** — 通过事前验尸预判失败，做好准备
3. **从创新到保护** — 通过Protoloop保护第二轨道创新
4. **从现状到地图** — 通过沃德利地图理解演进趋势
5. **从选择到执行** — 通过制胜策略框架转化为可行动方案
这些技能相互配合，形成完整的战略决策支持体系，帮助用户在不确定的商业环境中做出更明智的选择。
---
## 上下文管理
### 相关页面
相关主题：[系统架构](#page-architecture), [诊断类技能](#page-diagnostic-skills)
相关源码文件
以下源码文件用于生成本页说明：
- [install/company-context.md](https://github.com/eterdis/strategy-skills/blob/main/install/company-context.md)
- [strategy-diagnostic/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/strategy-diagnostic/SKILL.md)
- [SKILL-TEMPLATE.md](https://github.com/eterdis/strategy-skills/blob/main/SKILL-TEMPLATE.md)
- [README.md](https://github.com/eterdis/strategy-skills/blob/main/README.md)
- [wardley-map/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/wardley-map/SKILL.md)
- [first-principles-strategy/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/first-principles-strategy/SKILL.md)
- [pre-mortem/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/pre-mortem/SKILL.md)
- [install/skills/vrio.md](https://github.com/eterdis/strategy-skills/blob/main/install/skills/vrio.md)
# 上下文管理
## 概述
上下文管理是 Eterdis Strategy Skills 框架中的核心持久化机制，用于在多次会话之间累积和传递战略情报。所有技能模块通过共享的 `company-context.md` 文件实现跨会话状态保持，确保 AI 代理能够基于历史分析持续深化战略洞察。
该系统解决了 AI 对话式战略咨询中的关键问题：每次会话不应从头开始，而应继承已收集的信息并在此基础上继续演进。上下文文件作为"活文档"被所有技能读取和更新，形成一个累积式的战略知识库。
资料来源：[README.md:1-15]()
---
## 核心概念：上下文文件
### 文件定位与用途
上下文文件位于 `install/company-context.md`，是一个结构化的 Markdown 文档，包含组织的核心战略信息。每个技能在会话开始时读取该文件，在会话结束时更新写入。
资料来源：[install/company-context.md:1-10]()
### 上下文文件的核心价值
| 价值维度 | 说明 |
|---------|------|
| 连续性 | 跨会话保持分析状态，避免重复劳动 |
| 验证追踪 | 时间戳记录各部分的最后验证时间 |
| 假设管理 | 识别过时假设并触发重新评估 |
| 协作基础 | 为多个技能提供统一的组织认知基础 |
资料来源：[SKILL-TEMPLATE.md:1-30]()
---
## 文件结构
`company-context.md` 采用结构化分区设计，每个区域存储特定类型的战略信息：
### 组织基础信息
```markdown
## Organisation
- **Name:**
- **Industry:**
- **Size:** (employees, revenue range)
- **Geography:** (where you operate)
- **Ownership:** (private, PE-backed, listed, family, public sector)
- **Last updated:**
```
资料来源：[install/company-context.md:11-18]()
### 业务描述
```markdown
## What pays the bills
Describe your current business in plain language. What do you sell, to whom, and how do you make money?
- **Last updated:**
```
资料来源：[install/company-context.md:19-24]()
### 关键资源清单
该区域采用表格形式追踪组织核心竞争力：
| Resource | Type | VRIO status | Last validated |
|---|---|---|---|
| | | | |
VRIO 状态字段与 `vrio.md` 技能联动，存储资源分析的动态评估结果。
资料来源：[install/company-context.md:25-32]()
### 客户信息
```markdown
## Customers
Who actually buys? Not the target market slide — the real customers.
- **Core segments:**
- **Why they choose you:**
- **What would make them leave:**
- **Last updated:**
```
资料来源：[install/company-context.md:33-40]()
### 竞争格局
```markdown
## Competitive landscape
| Competitor | Their advantage | Your advantage vs. them | Threat level | Last reviewed |
|---|---|---|---|---|
| | | | | |
```
资料来源：[install/company-context.md:41-47]()
### 当前战略与财务
```markdown
## Current strategy
What is the strategy — in one paragraph?
## Financial situation
Revenue trajectory, margins, cash position, investment capacity.
```
资料来源：[install/company-context.md:48-55]()
---
## 上下文管理流程
### 会话模式判定
每个技能在启动时首先检查上下文文件状态，以确定会话模式：
```mermaid
graph TD
A[开始会话] --> B{company-context.md 存在?}
B -->|否| C[Diagnostic 模式
完整诊断会话]
B -->|是| D{存在特定分析记录?}
D -->|否| C
D -->|是| E{内容陈旧?}
E -->|是| F[Review 模式
更新现有分析]
E -->|否| G[Alert Triggers 模式
检查预警信号]
```
资料来源：[first-principles-strategy/SKILL.md:1-25]()
### 模式说明
| 模式 | 触发条件 | 会话时长 | 目标 |
|------|----------|----------|------|
| **Diagnostic** | 首次运行或重大变更 | 30-60 分钟 | 全面诊断 |
| **Review** | 已存在历史分析 | 15-20 分钟 | 更新验证 |
| **Alert Triggers** | 设置预警监控 | 10-15 分钟 | 定义触发条件 |
资料来源：[pre-mortem/SKILL.md:1-35]()
### 读写操作时序
```mermaid
sequenceDiagram
participant User as 用户
participant Agent as AI 代理
participant Context as company-context.md
User->>Agent: 开始会话
Agent->>Context: 读取现有上下文
Context-->>Agent: 返回累积数据
Agent->>Agent: 分析上下文状态
Note over Agent: 判定会话模式
Agent->>User: 提出开场问题
User->>Agent: 提供新信息
Agent->>Agent: 更新诊断状态
Agent->>User: 深入探测
loop 多个迭代
User->>Agent: 反馈信息
Agent->>Agent: 框架应用与分析
end
Agent->>Context: 综合发现更新上下文
Context-->>Agent: 确认保存
Agent->>User: 呈现综合结果
```
资料来源：[strategy-diagnostic/SKILL.md:1-50]()
---
## 技能间的上下文联动
### 诊断入口
`strategy-diagnostic` 是所有战略技能的统一入口点，负责初始评估并引导用户进入相应框架：
> "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?"
资料来源：[strategy-diagnostic/SKILL.md:1-20]()
### 诊断状态内部管理
技能在运行时维护一个不对用户显示的内部诊断状态：
```
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]
KEY FINDINGS:
1. [finding]
2. [finding]
OPEN QUESTIONS:
- [what you still don't know]
```
此内部状态驱动技能的下一步探测方向，并在会话结束时同步到 `company-context.md`。
资料来源：[strategy-diagnostic/SKILL.md:20-45]()
### 上下文驱动的技能路由
| 信号类型 | 建议框架 | 上下文更新内容 |
|---------|---------|---------------|
| 资源竞争分析 | VRIO | 资源 VRIO 状态 |
| 外部环境变化 | Environmental Radar | PESTEL 因素 |
| 文化执行障碍 | Culture Assessment | 文化评估结果 |
| 重大决策前 | Pre-Mortem | 失败模式分析 |
| 无增长方向 | Protoloop | Track Two 设计 |
资料来源：[strategy-diagnostic/SKILL.md:45-80]()
---
## 上下文文件的生命周期管理
### 时间戳追踪机制
每个上下文分区都包含 `Last updated` 或 `Last validated` 字段，标识该部分信息的上次修改时间。这一设计支持：
1. **过期检测**：识别长期未更新的假设
2. **版本追踪**：了解战略信息的演进历史
3. **优先级判断**：优先处理陈旧区域的更新
资料来源：[install/company-context.md:1-10]()
### 上下文陈旧警告
当技能检测到上下文中的某些部分长时间未更新时，会主动提醒用户验证或更新：
```markdown
> Timestamps track when each section was last validated.
> Stale assumptions get flagged.
```
资料来源：[install/company-context.md:1-5]()
---
## 框架特定上下文扩展
### Wardley Map 上下文
Wardley Map 技能在上下文文件中存储：
- 用户需求锚点定义
- 价值链组件及其依赖关系
- 组件演进阶段评估
- 战略位置与移动分析
资料来源：[wardley-map/SKILL.md:1-80]()
### First Principles 上下文
First Principles 技能管理：
- 理论最大值分析结果
- 现有约束清单（区分物理约束与惯例约束）
- 假设列表及其验证状态
- 工作反向路径规划
资料来源：[first-principles-strategy/SKILL.md:1-50]()
### Pre-Mortem 上下文
Pre-Mortem 技能维护：
- 计划/决策的失败模式分析
- 关键假设清单及监控触发器
- 猴子测试（Monkey Test）结果
- 预警信号定义
资料来源：[pre-mortem/SKILL.md:1-60]()
### VRIO 上下文
VRIO 分析技能存储：
- 资源/能力详细清单
- 四问评估结果（价值性、稀有性、模仿性、组织性）
- 竞争优势可持续性评估
- 资源缺口分析
资料来源：[install/skills/vrio.md:1-40]()
---
## 使用指南
### 首次使用
1. 创建空的 `company-context.md` 文件
2. 启动 `strategy-diagnostic` 技能作为入口
3. 通过诊断会话逐步填充各区域
4. 技能自动添加 `Last updated` 时间戳
### 定期维护
- **每月Review**：检查所有分区的 `Last updated` 时间
- **重大事件后**：更新战略和竞争格局区域
- **季度审计**：验证资源 VRIO 状态是否仍然准确
### 多技能协同
当需要在不同框架间切换时，诊断技能会：
1. 读取当前上下文
2. 识别已完成和待完成的分析
3. 确定最佳切入角度
4. 避免重复提问，直接聚焦差异区域
资料来源：[SKILL-TEMPLATE.md:1-25]()
---
## 技术实现要点
### 状态隔离
- AI 代理的内部诊断状态对用户隐藏
- 仅最终确认的分析结果写入上下文文件
- 会话过程中的临时推论不污染持久化存储
### 增量更新
- 上下文更新采用增量而非覆盖策略
- 已验证的内容保留时间戳标记
- 新增分析追加到对应分区
### 模式自适应
技能能够根据上下文状态自动调整：
- 已有完整 VRIO 分析时，跳过资源清单收集
- 存在 Pre-Mortem 结果时，聚焦于失败模式更新
- 上下文完全空白时，执行完整诊断流程
资料来源：[strategy-diagnostic/SKILL.md:1-30]()
---
## 最佳实践
| 实践 | 说明 |
|------|------|
| 保持简洁 | 每个字段使用简短描述，便于快速阅读 |
| 验证优先 | 定期验证而非等到问题出现 |
| 诚实记录 | 记录"实际"而非"应该"的状态 |
| 追踪矛盾 | 当新分析与历史记录冲突时主动标注 |
| 设置提醒 | 对陈旧区域设置外部提醒机制 |
---
## 相关技能
- [strategy-diagnostic](strategy-diagnostic/) — 上下文初始化与技能路由
- [strategy-map](strategy-map/) — 战略地图构建
- [vrio-analysis](vrio-analysis/) — 资源竞争力分析
- [wardley-map](wardley-map/) — 价值链与环境演进分析
- [pre-mortem](pre-mortem/) — 决策前风险评估
- [first-principles](first-principles-strategy/) — 假设解构与重建
- [culture-assessment](culture-assessment/) — 组织文化诊断
---
## 技能开发模板
### 相关页面
相关主题：[贡献指南](#page-contributing), [技能目录](#page-skills-catalog)
相关源码文件
以下源码文件用于生成本页说明：
- [SKILL-TEMPLATE.md](https://github.com/eterdis/strategy-skills/blob/main/SKILL-TEMPLATE.md)
- [README.md](https://github.com/eterdis/strategy-skills/blob/main/README.md)
- [wardley-map/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/wardley-map/SKILL.md)
- [strategy-diagnostic/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/strategy-diagnostic/SKILL.md)
- [vrio-analysis/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/vrio-analysis/SKILL.md)
- [first-principles-strategy/SKILL.md](https://github.com/eterdis/strategy-skills/blob/main/first-principles-strategy/SKILL.md)
# 技能开发模板
## 概述
技能开发模板（Skill Template）是 Eterdis Strategy Skills 项目的核心组成部分，为开发者提供创建标准化 AI 策略思维伙伴的结构化框架。该模板基于 20 年咨询实践经验设计，遵循 [Agent Skills 规范](https://agentskills.io) 的 SKILL.md 格式要求。
**核心定位：** 技能是一系列结构化提示词，引导大语言模型（LLM）通过经过验证的战略框架，向用户提出正确的问题、发现模式、揭示矛盾并产出可操作的输出。
**技术特性：**
- 模型无关性 — 支持 Claude、ChatGPT、Gemini 及任何支持 Markdown 读取的模型
- 标准化结构 — 统一的三模式运行机制（诊断、回顾、预警触发）
- 上下文持久化 — 通过共享的 `company-context.md` 文件累积战略智能
- 对话驱动 — 通过 AI 引导的对话而非静态文档完成策略分析
资料来源：[README.md:1-15]()
## 模板整体结构
技能模板采用模块化架构，由元数据区、上下文加载区、主体内容区和边界定义区四部分组成。
```mermaid
graph TD
A[SKILL.md] --> B[元数据区
name/description/homepage]
A --> C[上下文加载区
company-context.md]
A --> D[主体内容区
阶段/步骤定义]
A --> E[边界定义区
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 代理何时应使用此技能
- 描述触发技能的问题或情境类型
- 保持具体，避免泛泛而谈
资料来源：[SKILL-TEMPLATE.md:1-12]()
## 三模式运行机制
技能支持三种运行模式，统一入口设计确保用户体验的一致性。
### 模式概览
| 模式 | 用途 | 预计时长 | 触发条件 |
|------|------|----------|----------|
| **Diagnostic** | 首次深度会话 | 30-60 分钟 | 无历史记录或计划有重大变更 |
| **Review** | 周期性重新评估 | 15-20 分钟 | 存在历史记录且计划未大幅变化 |
| **Alert Triggers** | 预警监控设置 | 10-15 分钟 | 设置或检查预警信号 |
### 模式选择流程
```mermaid
graph TD
A[开始] --> B{company-context.md
存在历史记录?}
B -->|是| C{上次分析类型?}
B -->|否| D[Diagnostic 模式]
C -->|预演分析| E{计划有重大变更?}
C -->|其他类型| F{Review 模式
还是 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` 文件实现跨会话状态持久化。
**加载逻辑：**
1. 技能启动时检查 `company-context.md` 是否存在
2. 若存在，读取相关章节并生成开场反思
3. 若不存在，通过开场问题引导用户建立初始上下文
**开场反思格式示例：**
> "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]()
### 上下文文件结构
```markdown
# Company Context
## Organisation
- Name: [组织名称]
- Industry: [行业]
- Size: [规模]
## What pays the bills
[商业模式描述]
## Resources that matter
[VRIO 资源表]
## Session log
[会话历史记录]
```
## 阶段设计规范
### 阶段结构模板
每个技能应包含 2-4 个主要阶段（Phase），每个阶段遵循统一结构：
| 组成部分 | 说明 |
|----------|------|
| **阶段名称** | 简洁的标题，概括阶段目的 |
| **目标描述** | 该阶段要实现什么 |
| **问题列表** | 引导性问题，驱动对话 |
| **倾听要点** | 需要关注的信号类型 |
| **方向指示** | 不同回答如何影响后续流程 |
### 阶段示例结构
```markdown
## [阶段名称]
[描述该阶段的目的和范围]
### 提问
- [主要开场问题]
- [跟进问题 1]
- [跟进问题 2]
### 倾听要点
- 用户首先提到什么（优先级信号）
- 用户刻意跳过什么（盲点信号）
- 用户如何组织叙述（思维模式信号）
### 后续路径
- 若 [信号 A] → 进入 [阶段/方向]
- 若 [信号 B] → 深入探索 [主题]
```
资料来源：[SKILL-TEMPLATE.md:30-50]()
## 模式与信号表格
模式与信号（Patterns and Red Flags）部分帮助实践者识别常见情况并采取适当行动。
### 表格格式规范
| 信号 | 含义 | 探测方式 |
|------|------|----------|
| [可观察现象] | [潜在问题] | [跟进问题或方法] |
| ... | ... | ... |
### 设计原则
1. **可观察性** — 表格中的信号应是外部可观察的行为或陈述
2. **可操作性** — 每种信号应关联具体的下一步行动
3. **非排他性** — 同一现象可能对应多种解释，需结合上下文判断
## 综合输出规范
当对话达到自然停止点时，技能应产出标准化综合输出。
### 输出结构
```markdown
## 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?"
```
### 会话状态维护
技能应在内部维护运行状态，不向用户展示但指导决策：
```markdown
## 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:
1. [finding]
2. [finding]
OPEN QUESTIONS:
- [what you still don't know]
```
```
资料来源：[strategy-diagnostic/SKILL.md:12-30]()
## 边界定义
每个技能必须明确声明其覆盖范围之外的内容。
### 边界部分格式
```markdown
## Boundaries
This skill does NOT cover:
- [明确排除的内容]
- [相邻但属于其他技能的主题]
If [特定信号], suggest switching to [其他技能名称].
```
### 边界设计原则
- 避免技能功能重叠导致的混乱
- 为用户推荐更合适的技能路径
- 保持技能职责单一性
## 创建新技能指南
### 开发流程
```mermaid
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 更新说明
## 最佳实践
### 提问设计
1. **单一入口原则** — 每阶段以一个核心问题开场，避免问卷式提问
2. **沉默引导** — 提出问题后停止说话，让用户充分表达
3. **跟进策略** — 基于用户回答选择性使用 2-3 个跟进问题
### 对话节奏
| 阶段 | 建议时长 | 节奏控制 |
|------|----------|----------|
| 开场 | 5-10 分钟 | 广泛倾听，不急于框架 |
| 深入 | 20-40 分钟 | 聚焦发现，验证假设 |
| 综合 | 5-10 分钟 | 梳理输出，确认遗漏 |
### 矛盾处理
当用户陈述出现矛盾时：
1. 内部记录矛盾点
2. 在后续对话中温和验证
3. 在 Synthesis 中明确指出
4. 询问用户哪个理解是正确的
## 与其他技能的关系
技能库中的技能相互关联，形成战略分析工具链：
```mermaid
graph LR
A[entry] --> B[strategy-diagnostic
诊断入口]
B --> C[strategy-map
因果链分析]
B --> D[wardley-map
演进图谱]
B --> E[vrio-analysis
竞争优势]
B --> F[first-principles
第一性原理]
B --> G[environmental-radar
外部环境]
B --> H[market-position
市场定位]
C --> I[pre-mortem
预演分析]
D --> I
I --> J[protoloop
创新保护]
```
**技能协作示例：**
- `strategy-diagnostic` 作为入口，检测应使用哪个框架
- `wardley-map` 分析组件演进阶段，指导战略选择
- `vrio-analysis` 验证竞争优势的可持续性
- `pre-mortem` 压力测试选定的战略方向
资料来源：[README.md:25-40]()
## 扩展阅读
- [Agent Skills 规范](https://agentskills.io) — SKILL.md 格式官方文档
- [Wardley Maps](https://wardleymaps.com/) — 演进图谱理论创始人 Simon Wardley
- [VRIO Framework](https://en.wikipedia.org/wiki/VRIO_Framework) — Jay Barney 1991 年提出的资源分析框架
---
## 贡献指南
### 相关页面
相关主题：[技能开发模板](#page-skill-template), [项目介绍](#page-intro)
相关源码文件
以下源码文件用于生成本页说明：
- [CONTRIBUTING.md](https://github.com/eterdis/strategy-skills/blob/main/CONTRIBUTING.md)
- [SKILL-TEMPLATE.md](https://github.com/eterdis/strategy-skills/blob/main/SKILL-TEMPLATE.md)
- [README.md](https://github.com/eterdis/strategy-skills/blob/main/README.md)
- [mcp-server/package.json](https://github.com/eterdis/strategy-skills/blob/main/mcp-server/package.json)
# 贡献指南
本文档介绍如何为 strategy-skills 项目做出贡献。该项目是一组开源的战略框架，以 AI 引导的对话形式运行。贡献者可以通过提交新的技能（Skills）、改进现有技能或修复问题来参与项目。
## 项目概述
### 项目定位
strategy-skills 是一个基于 20 年咨询实践经验开发的开源策略框架集合。这些技能以结构化提示词的形式存在，可将任何大型语言模型转变为战略思维伙伴。资料来源：[README.md:1-9]()
### 核心特性
| 特性 | 说明 |
|------|------|
| 模型无关性 | 支持 Claude、ChatGPT、Gemini 及任何可读取 Markdown 的模型 |
| 三种运行模式 | Diagnostic（诊断）、Review（审查）、Alert Triggers（预警触发） |
| 共享上下文 | 所有技能读写共享的 `company-context.md` 文件 |
| 免费开源 | 基于咨询实践积累，免费提供给社区使用 |
## 贡献范围
### 可贡献的内容
根据项目性质，贡献主要涵盖以下领域：
1. **新技能开发** — 创建符合 SKILL.md 格式的新战略框架技能
2. **现有技能改进** — 优化问题设计、改进流程、增强诊断能力
3. **文档完善** — 补充示例、修正说明、优化可读性
4. **代码增强** — MCP 服务器功能扩展、工具脚本开发
### 技能模板规范
所有技能必须遵循 SKILL-TEMPLATE.md 定义的统一格式。模板核心结构如下：
```markdown
---
name: eterdis-your-skill-name
description: >
技能描述段落，说明何时使用、适用场景、触发条件
homepage: https://eterdis.com/skills/your-skill-name
---
# 技能标题
## Loading Company Context
- 检查并读取 company-context.md
- 使用已有上下文或提出开场问题
## 主体内容
- 问题设计
- 阶段/步骤定义
- 模式识别
- 预警触发器
## 边界定义
- 明确技能覆盖范围
- 明确超出范围的内容
- 定义何时应切换到其他技能
```
资料来源：[SKILL-TEMPLATE.md:1-35]()
## 技能结构规范
### 标准技能目录结构
```
strategy-skill-name/
└── SKILL.md # 核心技能文件
```
每个技能目录下应包含一个 `SKILL.md` 文件，这是技能的唯一起点。资料来源：[SKILL-TEMPLATE.md:1]()
### 必需元数据
技能文件顶部必须包含 YAML front matter：
```yaml
---
name: eterdis-[技能名称]
description: >
单段落描述，说明技能用途、触发条件、适用场景
homepage: https://eterdis.com/skills/[技能名称]
---
```
### 核心组成部分
一个完整的技能应包含以下章节：
| 章节 | 用途 | 重要性 |
|------|------|--------|
| Loading Company Context | 检查共享上下文，确定运行模式 | 必需 |
| 阶段/步骤定义 | 描述技能执行的主要流程 | 必需 |
| Patterns and Red Flags | 识别常见模式和警示信号 | 推荐 |
| Synthesis | 定义输出格式和总结要求 | 必需 |
| Boundaries | 明确技能边界和适用范围 | 推荐 |
| Alert Triggers | 设置预警条件和重新评估触发器 | 可选 |
## 运行模式
所有技能支持三种标准运行模式，贡献者应确保新技能覆盖这些模式：
### 诊断模式（Diagnostic）
深度首次会话，持续 30-60 分钟。用于全面评估和框架应用。资料来源：[README.md:15-17]()
### 审查模式（Review）
定期重新评估，持续 15-20 分钟。用于检查上下文变化和更新分析。资料来源：[README.md:18-19]()
### 预警触发器模式（Alert Triggers）
早期预警监控机制。在会话间设置条件，触发重新评估。资料来源：[README.md:20-21]()
## MCP 服务器集成
项目包含 MCP（Model Context Protocol）服务器实现，位于 `mcp-server/` 目录。贡献者如需扩展服务器功能，应了解以下技术栈：
```json
{
"name": "@eterdis/mcp-server",
"version": "1.0.0",
"dependencies": {
"@modelcontextprotocol/sdk": "^1.29.0",
"zod": "^3.25.0"
},
"devDependencies": {
"@types/node": "^22.0.0",
"typescript": "^5.7.0"
}
}
```
资料来源：[mcp-server/package.json:1-20]()
### 服务器开发规范
1. 使用 TypeScript 开发
2. 依赖 Model Context Protocol SDK
3. 使用 Zod 进行数据验证
4. 遵循项目既定的目录结构
## 贡献流程
### 标准提交流程
```mermaid
graph TD
A[Fork 仓库] --> B[创建功能分支]
B --> C[阅读 SKILL-TEMPLATE.md]
C --> D[开发或修改技能]
D --> E[遵循格式规范]
E --> F[提交 Pull Request]
F --> G[等待代码审查]
G --> H{审查结果}
H -->|需要修改| I[进行修改后重新提交]
H -->|通过| J[合并到主分支]
```
### 分支命名规范
| 分支类型 | 命名模式 | 示例 |
|----------|----------|------|
| 新技能 | `skill/[技能名称]` | `skill/competitive-analysis` |
| 功能改进 | `feature/[功能描述]` | `feature/mcp-tool-extension` |
| 文档修复 | `docs/[文档类型]` | `docs/contributing-update` |
| 问题修复 | `fix/[问题描述]` | `fix/context-sync-bug` |
## 质量标准
### 技能质量检查清单
在提交前，确保技能满足以下标准：
- [ ] 包含完整的 YAML front matter
- [ ] 遵循 SKILL-TEMPLATE.md 格式
- [ ] 提供清晰的阶段/步骤定义
- [ ] 包含 Patterns and Red Flags 表格（如适用）
- [ ] 定义明确的边界和适用范围
- [ ] 所有链接和引用有效
- [ ] 使用中文编写主体内容
- [ ] 示例和场景说明具体可操作
### 代码质量要求
对于 MCP 服务器代码：
| 要求 | 说明 |
|------|------|
| TypeScript 类型安全 | 所有函数和变量必须有明确类型 |
| 测试覆盖 | 核心功能需包含单元测试 |
| 文档完整 | 公共 API 必须有 JSDoc 注释 |
| 提交规范 | 使用语义化提交信息 |
## 现有技能参考
项目已实现的技能可作为贡献参考：
| 技能名称 | 目录路径 | 功能描述 |
|----------|----------|----------|
| strategy-diagnostic | `strategy-diagnostic/` | 战略评估入口点 |
| strategy-map | `strategy-map/` | 资源到结果的因果链映射 |
| vrio-analysis | `vrio-analysis/` | 竞争优势 VRIO 测试 |
| environmental-radar | `environmental-radar/` | PESTEL 外部环境扫描 |
| market-position | `market-position/` | 竞争定位分析 |
| wardley-map | `wardley-map/` | Wardley 地图绘制 |
| first-principles-strategy | `first-principles-strategy/` | 第一性原理分析 |
| pre-mortem | `pre-mortem/` | 计划预演分析 |
| culture-assessment | `culture-assessment/` | 组织文化评估 |
资料来源：[README.md:32-43]()
## 社区参与
### 反馈渠道
- 通过 GitHub Issues 报告问题
- 通过 Pull Request 提交改进
- 关注项目更新获取最新技能
### 许可说明
本项目采用开源模式运营，免费提供给社区使用。贡献者应理解并接受其贡献将被开源共享。资料来源：[README.md:3-6]()
## 快速开始
贡献新技能的基本步骤：
1. 阅读 [SKILL-TEMPLATE.md](SKILL-TEMPLATE.md) 了解模板格式
2. 参考现有技能结构，如 [strategy-diagnostic](strategy-diagnostic/SKILL.md)
3. 创建技能目录和 SKILL.md 文件
4. 遵循三模式结构设计对话流程
5. 提交 Pull Request 请求审查
---
---
## Doramagic 踩坑日志
项目：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