初始化 SDD 工作区：
spec/global/ 知识库目录触发方式： 手动触发，用户运行 /sdd-global-init
.sdd-workspace 文件，记录工作区路径，供后续 SDD skill 使用检查当前 OpenClaw workspace 中是否存在 .sdd-workspace 配置文件：
workspace_path 作为默认工作区如果无现有配置，或用户选择新建，使用 AskUserQuestion 展示选项：
/home/maqb11/.openclaw/workspace/ 作为工作区选项展示：
📂 请选择工作区目录：
1. 使用当前 workspace: /home/maqb11/.openclaw/workspace/
2. 指定已有目录（请输入路径）
3. 创建新目录（请输入目录名）
使用 AskUserQuestion 让用户选择，然后验证目录是否存在：
{workspace}/{dirname}/在选定的工作区根目录创建 .sdd-workspace 配置文件：
{
"workspace_path": "/path/to/workspace",
"initialized_at": "2026-03-16T17:00:00+08:00",
"sdd_version": "1.0"
}
后续所有 SDD skill 都通过读取这个配置文件获取工作区路径。
检查当前模型是否为 Opus（检查 system prompt 中的模型信息）。如果不是 Opus，输出以下纯文本提示并继续（非阻塞）：
⚠️ 当前模型不是 Opus，全局 spec 初始化需要较强的理解和摘要能力，建议切换到 Opus。输入 /model 切换模型。
从 .sdd-workspace 读取工作区路径 {workspace}，检查 {workspace}/spec/global/ 目录是否存在：
在工作区目录中扫描项目以构建全面的图景：
AI 扫描工作区中的代码库：
> 注意： 工作区目录下可能包含多个项目，优先扫描主要项目。
展示所有待生成文档的大纲（目录结构 + 每个文档的核心要点）。使用 AskUserQuestion 一次性让用户确认或请求修改。
大纲格式示例：
📋 全局 Spec 初始化大纲
{workspace}/spec/global/
├── constraints.md — 项目架构约束
│ ├── 技术栈: TypeScript, React, Express...
│ ├── 架构决策: Monorepo, RESTful...
│ └── 编码规范 / 部署方式 / 安全约束
├── overview.md — 项目概述
│ ├── 项目目标: ...
│ ├── 核心用户: ...
│ ├── 系统边界: ...（外部依赖）
│ └── 核心业务流程: ...
├── architecture.md — 架构全景
│ ├── 系统组件图: ...
│ ├── 模块划分: ...
│ ├── 数据流: ...
│ └── 部署拓扑: ...
├── features.md — 已有功能清单
│ ├── 模块A: 功能点1, 功能点2...
│ ├── 模块B: 功能点1, 功能点2...
│ └── ...
├── index.md — 归档索引（空表）
├── images/ — 配图目录
└── domains/ — 领域目录（空）
将 ... 占位符替换为扫描发现的实际信息。
如果用户选择 "需要修改"，询问要修改什么，调整大纲后重新确认。
用户确认大纲后，一次性生成所有文档——不逐个文档确认：
{workspace}/spec/ 目录{workspace}/spec/global/ 目录{workspace}/spec/global/domains/ 目录（空）{workspace}/spec/global/images/ 目录（空）{workspace}/spec/global/domains/images/ 目录（空）{workspace}/spec/global/constraints.md，填入发现的信息。无法确定的维度使用 "（未检测到）"。{workspace}/spec/global/overview.md，填入发现的信息。{workspace}/spec/global/architecture.md，填入发现的信息。{workspace}/spec/global/features.md，填入发现的信息。{workspace}/spec/global/index.md，包含空的功能表。constraints.md 与 architecture.md 的区别：
配图占位： 每个文档模板都包含 !描述 引用。在文档写作时根据配图触发规则插入这些引用。
所有文档写完后，收集配图需求并逐一生成配图。
扫描所有生成的文档中的 !... 引用。为每个引用构建清单条目：
{
"description": "描述文字（用于图片生成 prompt）",
"type": "architecture|feature-relationship|tech-stack|concept",
"style": "根据 Style Mapping 确定",
"aspect_ratio": "16:9 或 1:1",
"output_path": "spec/global/images/NN-type.png"
}
配图始终输出到 {workspace}/spec/global/images/ 或 {workspace}/spec/global/domains/images/。
遍历清单，逐一生成配图：
对于清单中的每个配图：
🖼️ 正在生成第 X/N 张：{description}.../gen-image skill，参数：prompt={description + style prefix}, aspect_ratio, size=1K, output={workspace}/spec/global/images/{filename}✅ 已保存: {output_path}⚠️ 生成失败: {description}，已跳过 并继续下一个配图所有配图处理完后，显示总结：
🖼️ 配图全部生成完成（{N} 张）🖼️ 配图生成完成: {X} 张成功，{Y} 张失败用中文显示简洁总结：
✅ SDD 工作区初始化完成
📂 工作区: {workspace}
📁 生成目录: {workspace}/spec/global/
📝 生成的文件:
- spec/global/index.md（归档索引）
- spec/global/overview.md（项目概述）
- spec/global/architecture.md（架构全景）
- spec/global/features.md（已有功能清单）
- spec/global/constraints.md（架构约束）
🖼️ 配图: X 张生成成功
{或: 🖼️ 配图: X 张成功，Y 张失败（{失败文件列表}）}
💡 工作区已记录到 .sdd-workspace 配置文件
💡 后续所有 SDD 操作将在此工作区进行
💡 如需修改全局文档，请使用 /sdd-global-change。
在工作区根目录创建 .sdd-workspace JSON 配置文件：
{
"workspace_path": "/absolute/path/to/workspace",
"initialized_at": "2026-03-16T17:00:00+08:00",
"sdd_version": "1.0"
}
后续所有 SDD skill（sdd-brainstorming, sdd-writing-plans 等）在执行时必须：
.sdd-workspaceworkspace_path 作为工作区根目录spec/ 相关路径都基于工作区路径：{workspace}/spec/...# 项目全局 Spec 索引
## 项目概况
→ [overview.md](./overview.md) — 项目概述
→ [architecture.md](./architecture.md) — 架构全景
→ [features.md](./features.md) — 已有功能清单
→ [constraints.md](./constraints.md) — 架构约束
## 已归档 Feature
| Feature ID | 摘要 | 领域 | 归档日期 |
|-----------|------|------|----------|
## 领域索引
# 项目概述
## 项目目标
{项目是什么、解决什么问题}
## 核心用户
{目标用户群体及其核心需求}
## 系统边界
{系统与哪些外部服务交互，业务视角}
- **{外部服务名}:** {作用描述}
## 核心业务流程
{主要的 1-3 个业务流程简述}
---
*最后更新: YYYY-MM-DD — 初始化生成*
# 架构全景
## 系统组件
{各组件及其职责}
## 模块划分
{代码中的核心模块、它们的边界和职责}
## 数据流
{核心数据如何在组件间流动}
## 外部集成
{技术层面的外部服务集成细节：端口、协议、认证方式等}
## 部署拓扑
{各服务如何部署、容器编排等}
---
*最后更新: YYYY-MM-DD — 初始化生成*
# 已有功能清单
## {模块名}
- **{功能点}:** {一句话描述}
- **{功能点}:** {一句话描述}
## {模块名}
...
---
*最后更新: YYYY-MM-DD — 初始化生成*
# 项目架构约束
## 技术栈
- **语言:** ...
- **前端框架:** ...
- **后端框架:** ...
- **数据库:** ...
- **缓存:** ...
- **构建工具:** ...
- **包管理器:** ...
## 架构决策
- **目录结构:** ...
- **分层架构:** ...
- **状态管理:** ...
- **通信模式:** ...
## API 风格
- **风格:** RESTful / GraphQL / ...
- **认证方式:** ...
- **错误处理:** ...
## 编码规范
- **命名约定:** ...
- **文件组织:** ...
## 部署方式
- **环境:** ...
- **CI/CD:** ...
## 安全约束
- ...
---
*最后更新: YYYY-MM-DD — 初始化生成*
| 配图类型 | Style prefix | 宽高比 |
|---|---|---|
| ----------- | ------------- | ------------- |
| 架构/数据流 | Technical diagram, vector style | 16:9 |
| 功能关系 | Clean flat flowchart, minimal | 16:9 |
| 技术栈概览 | Technical diagram, vector style | 16:9 |
| 概念图示 | Flat design, soft pastel | 1:1 或 16:9 |
/sdd-global-initspec/global/ 已存在，拒绝并停止./images/ 相对路径 — 相对于工作区的 spec/global/images/共 1 个版本