four-core-documents

/digital-marketing-pro:four-core-documents — 战略主轴（61 个步骤）

此技能生成参与方法论的第 3 部分：四份共同从战略层面定义品牌的文档。每项渠道策略、每份创意简报、每段文案都会回溯到这些文档。

上下文效率

此技能较为复杂。先用 Grep 搜索，再 Read 任何引用文件；然后仅使用 offset + limit 读取匹配范围。打开文件前，先列出品牌的工作区 ~/.claude-marketing/brands/{slug}/（如果设置了该环境变量，则使用 $CLAUDE_PLUGIN_DATA/digital-marketing-pro/brands/{slug}/）。在会话中途重新调用时，跳过已在上下文中的文件。

规范： four-core-documents-spec.md — 四份文档共 61 个步骤的具体说明。

参与流程背景： engagement-flow-methodology.md — 说明第 3 部分在 12 部分流程中的位置。

前置条件

运行此技能前，请确认：

1. 品牌资料已存在于 ~/.claude-marketing/brands/{brand-slug}/profile.json。如果不存在，请先运行 /digital-marketing-pro:brand-setup。
2. 参与流程已初始化，且状态文件 _engagement.json 已存在。如果没有，请先运行 /digital-marketing-pro:engagement start。
3. 第 1 部分（客户输入）已完成。开始第 3 部分前，必须记录确定事实和观点假设。
4. 第 2 部分（外部研究）至少已启动。第 2 部分的部分研究可以与第 3 部分并行进行，但必须先启动。

如果任何前置条件不满足，请勿生成输出。请改为告知用户应先运行什么。

子命令

生成全部四份文档

/digital-marketing-pro:four-core-documents <brand-slug> <engagement-id>

按顺序生成 3.1、3.2、3.3、3.4。实际耗时因参与流程的复杂程度而异。

生成单份文档

/digital-marketing-pro:four-core-documents <brand-slug> <engagement-id> --doc 3.1

仅生成指定文档。适用于重新运行（第 6 部分），或需要单独重做某份文档的情况。

生成 v2 重新运行版本

/digital-marketing-pro:four-core-documents <brand-slug> <engagement-id> --view v2 --doc "3.1,3.3"

生成指定文档的 v2 版本。--doc 接受单个 ID（3.1）或逗号分隔的列表（"3.1,3.3"）。在决策矩阵触发重新运行后，于第 6 部分使用。（规范标志为 --doc、--view v2 和 --combined — 不存在 --docs。）

生成整合核心文档（3.C）

/digital-marketing-pro:four-core-documents <brand-slug> <engagement-id> --combined

将全部四份规范核心文档（每份的最新版本）整合为单个高管参考文件，其中包含总目录、总假设表和总来源索引。仅在高管受众需要单文件阅读时生成。

生成顺序

四份文档依次生成，因为每份都建立在前一份的基础上：

1. 3.1 业务与 SBU 分析（18 个步骤）— 基础文档，用于确立业务现实。
2. 3.2 细分框架（15 个步骤）— 依赖 3.1 中的 SBU 和客户数据。
3. 3.3 品牌定位与传播（19 个步骤）— 依赖 3.2 中的用户画像。
4. 3.4 DMFlow（9 个步骤）— 依赖 3.1、3.2 和 3.3，以制定渠道决策。

重新运行时，仅重新生成受影响的文档。其他文档保留当前版本。

按文档生成

3.1 — 业务与 SBU 分析（18 个步骤）

阅读 four-core-documents-spec.md 中 3.1 部分的规范。18 个步骤如下：

1. SBU 识别
2. SBU 划分理由
3. 各 SBU 的收入来源
4. 各 SBU 的单位经济效益
5. 价值链映射
6. 细化到任务层级的产品与服务组合
7. 定价架构
8. 组织与市场进入模式
9. 销售与分销架构
10. 附有证据的完整 SWOT 分析
11. 增长杠杆
12. 制约因素
13. 客户获取经济效益
14. 客户留存经济效益
15. 合作伙伴与渠道依赖
16. 风险状况
17. 对本次合作的战略意义
18. 未解问题

输入：

• part-01-client-inputs/stone-facts.json — 真实依据事实
• part-02-external-research/ — 公正的外部研究（行业数据、市场背景）
• 位于 ~/.claude-marketing/brands/{slug}/profile.json 的品牌档案
• （请勿将 Opinion 假设用作真实依据——它们是研究问题，而非事实）

输出：

engagements/{id}/part-03-four-core-documents/v1/3.1-business-and-sbu-analysis.md

（重新运行生成 v2 时：路径相同，但使用 v2/ 而非 v1/）

输出结构：

---
document: 3.1-business-and-sbu-analysis
version: v1.0
engagement: {engagement-id}
brand: {brand-slug}
produced: {iso-timestamp}
view: v1   # or v2 for re-runs
---

# 3.1 Business & SBU Analysis

## Step 1: SBU Identification

[Content for step 1]

## Step 2: SBU Separation Rationale

[Content for step 2]

... (all 18 steps, in order)

## Sources

[Numbered list of every cited source: client docs, public sources, industry reports, Stone facts referenced]

## Open Questions

[Anything that could not be answered with available info]

## Change Log

### v1.0 — {date}
- Initial unbiased research version produced from Part 2 + Stone facts.

3.2 — 细分框架（15 个步骤）

15 个步骤如下：

1. 目标群体识别
2. 根据各项标准对目标群体评分
3. 目标群体优先级排序
4. 目标群体子群体细分
5. 为每个主要目标群体制定用户画像（使用 actionable-persona-format.md）
6. 每个用户画像的行为特征
7. 每个用户画像的心理特征
8. 需求状态映射
9. 地理分布
10. （仅限 B2B）为每个用户画像绘制多利益相关方决策单元（使用 b2b-decision-making-unit.md）
11. （仅限 B2B）MQL 定义
12. （仅限 B2B）SQL 定义
13. （仅限 B2B）销售管线逻辑
14. 反向用户画像
15. 激活指导

对于 B2C 合作项目，跳过步骤 10–13。此技能会根据品牌档案的 business_model.type 字段识别 B2B 或 B2C。

输入：

• 刚生成的 3.1，用于 SBU 和客户基线
• 如有，part-04-competitive-customer-market/v1/4.3-customer-analysis.md（用于公正的客户研究）
• 品牌档案

输出：

engagements/{id}/part-03-four-core-documents/v1/3.2-segmentation-framework.md

3.3 — 品牌定位与传播（19 个步骤）

19 个步骤如下：

1. 考虑过的定位方案
2. 各方案的理由
3. 各方案的权衡
4. 最终选定的定位及其论证
5. 定位陈述（正式的一句话）
6. 明确权衡取舍
7. 品牌承诺
8. 品牌承诺的证明依据
9. 核心信息架构
10. 信息支柱（3–5 个）
11. 各支柱的证明依据
12. 各细分群体的信息差异
13. 全漏斗传播框架（TOFU/MOFU/BOFU/留存/倡导）
14. 语调原则
15. 明确的禁用表述
16. 敏感话题处理
17. 危机传播立场
18. 各渠道的应用指导
19. 尚未解决的定位问题

输入：

• 刚生成的 3.1 + 3.2
• 如有，part-04-competitive-customer-market/v1/4.2-competitor-positioning.md
• 品牌档案（用于了解当前品牌语调特征）

输出：

engagements/{id}/part-03-four-core-documents/v1/3.3-brand-positioning-and-communications.md

3.4 — DMFlow（9 个步骤）

这 9 个步骤：

1. 考量的渠道范围（使用 five-digital-markets.md）
2. 选择渠道，并说明每个渠道的理由
3. 为每个渠道设计漏斗架构
4. 规划付费／自然／赢得／自有渠道的媒体组合逻辑
5. 在业务层面制定预算分配逻辑（按 in-market-out-market.md 划分 In-Market 与 Out-Market）
6. 渠道间的相互依赖关系与排序
7. 转化框架
8. 衡量方法
9. 战略影响与赛道权重

输入：

• 3.1 + 3.2 + 3.3（刚刚生成）
• 品牌资料（当前渠道、预算范围）
• channel-families.md，用于了解 7 个渠道家族／17 个渠道的分类

输出：

engagements/{id}/part-03-four-core-documents/v1/3.4-dmflow.md

质量规范（适用于全部四份文档）

1. 每项主张都要引用来源。 不要写“我们认为”，只写“证据表明”，并注明引用来源。
2. 明确说明每项假设。 估算 CAC、LTV、市场规模等数据时，说明方法和输入数据。
3. 每项建议都要源自分析。 不得提出正文未予以支持的结论。
4. 避免泛泛而谈。 “品牌强大”是泛泛之谈。“根据 [source]，目标细分群体中的品牌认知度为 92%”则是具体表述。
5. 四份文档之间的引用必须保持一致。 3.2 中定义的用户画像，必须与 3.3 消息变体和 3.4 渠道选择中引用的用户画像相同。
6. **记录待解决的问题，**不要将其隐去。
7. 确定事实就是事实；观点假设应以问题形式呈现。 不要在文档中将观点提升为事实。
8. 多维决策框架（参见 decision-framework.md）适用于任何选择（渠道选择、用户画像优先级、定位取舍）。

单文件规范

每份文档都应生成一个包含所有步骤的单一文件。如果因输出限制而无法在一个回合内完成文档：

1. 保存当前已完成的部分文档
2. 在下一回合从中断处继续编辑同一个文件（绝不要新建文件）
3. 只有包含全部步骤后，文件才算完成

不存在隐藏的续写状态——该技能不会保留被截断的位置指针。已保存到磁盘的部分文件是唯一记录。如果文档在生成过程中被中断，请重新运行该文档：读取已保存的部分内容作为上下文，并将剩余步骤追加到同一个文件中。如果某次运行在项目阶段被中断，请通过 /digital-marketing-pro:resume 从该部分最后一个检查点产物处继续。已保存的文件始终是事实来源。

生成完成后

生成全部四份文档后（也可以逐份生成后）：

1. 更新项目实时指令文件：
   • 战略事实部分：提取定位陈述、主要用户画像摘要、渠道选择、单位经济效益
   • 版本历史部分：添加新的 v1.0 条目
2. 在 _engagement.json 中将第 3 部分（或相应的子文档）标记为已完成
3. 告知用户第 4 部分是顺理成章的下一步

v2 重新运行

使用 --view v2 调用时，该技能会：

1. 读取所请求文档的 v1 版本
2. 读取第 5 部分的客户验证文档（客户要求的更改）
3. 读取适用于此文档的相关更改子集
4. 生成 v2，并在标题部分列出相较于 v1 的变更：

## v1 → v2 Changes

- Section X (Step N): {what changed} — driven by {client validation finding ID}
- Section Y: ...

5. 保存至 v2/{doc-name}.md（v1 文件保持不变）
6. 通过 engagement-state.py bump-version 更新 _engagement.json 中的版本
7. 更新 LIF 中发生变化的战略事实

示例

示例 1：首次生成全部四份文档

User: Produce the four core documents for the Acme engagement.

Skill response:
1. Verify pre-conditions: brand profile ✓, engagement initialised ✓, Part 1 complete ✓, Part 2 in progress ✓
2. Begin 3.1 Business & SBU Analysis. Read Stone facts, Part 2 research, brand profile. Walk all 18 steps. Cite sources throughout. Save to v1/3.1-business-and-sbu-analysis.md.
3. Begin 3.2 Segmentation Framework. Read 3.1, Part 4.3 if available. Detect business model = B2B from profile, so include steps 10-13. Walk 15 steps. Save to v1/3.2-segmentation-framework.md.
4. Begin 3.3 Brand Positioning. Read 3.1, 3.2, Part 4.2 if available. Walk 19 steps. Save to v1/3.3-brand-positioning-and-communications.md.
5. Begin 3.4 DMFlow. Read 3.1, 3.2, 3.3. Apply 5 Digital Markets taxonomy. Walk 9 steps. Save to v1/3.4-dmflow.md.
6. Update LIF: positioning statement, primary persona, channel selections, blended CAC estimate.
7. Mark Part 3 completed.
8. Brief: "Part 3 complete. 4 documents, 61 steps. Total ~12,000 words across all four. Recommend reviewing 3.3 (positioning) carefully — the chosen positioning has notable trade-offs documented in step 6."

示例 2：第 5 部分完成后的 v2 重新运行

User: Re-run 3.3 and 3.4 as v2 — client rejected the positioning and we need to redo the channel mix as a result.

Skill response:
1. Verify Part 5 Client Validation Document exists with positioning rejection captured ✓
2. Begin 3.3 v2. Read 3.3 v1 + Client Validation Document. Re-do positioning per client direction. Add v1→v2 changes header. Save to v2/3.3-brand-positioning-and-communications.md.
3. Begin 3.4 v2. Read 3.4 v1 + (now updated) 3.3 v2. Re-do channel mix to align with new positioning. Add v1→v2 changes header. Save to v2/3.4-dmflow.md.
4. Bump versions: engagement-state.py bump-version --doc 3.3 + --doc 3.4
5. Update LIF: new positioning statement, new channel selections, version history.
6. Brief: "v2 re-runs complete. 3.1 and 3.2 unchanged (still v1.0). 3.3 and 3.4 now at v2.0. Both views remain available. Operating decisions should reference v2 docs."

示例 3：生成供高管审阅的综合核心文档

User: Produce the Combined Core Document for the executive presentation next week.

Skill response:
1. Verify all four core documents exist (latest version of each) ✓
2. Read 3.1 v1.0, 3.2 v1.0, 3.3 v2.0, 3.4 v2.0
3. Synthesise into single document with:
   - Master TOC at top
   - Each document as a major section
   - Master Assumptions Table (extract every "Assumption" call-out from all four docs)
   - Master Source Index (de-duplicated list of every source cited)
4. Save to part-03-four-core-documents/3.C-combined-core-document.md
5. Brief: "3.C produced. 60+ pages. Includes master TOC + assumptions table + source index. Recommended exports: PDF for the executive deck, DOCX if they want to annotate."

相关技能

• engagement-workflow — 编排包含第 3 部分的 12 部分流程
• client-validation-document — 第 5 部分的交付物，会触发 v2 重新运行
• 本技能使用的现有技能和 Agent：audience-intelligence、competitive-intel、market-intelligence、brand-guardian

相关参考资料

• four-core-documents-spec.md — 规范性的 61 步规格说明
• actionable-persona-format.md — 3.2 的第 5 步
• b2b-decision-making-unit.md — 3.2 的第 10 至 13 步（B2B）
• five-digital-markets.md — 3.4 的第 1 步
• in-market-out-market.md — 3.4 的第 5 步
• channel-families.md — 3.4 的第 2 步
• decision-framework.md — 在整个过程中用于决策
• unit-economics-framework.md — 3.1 的第 4 步