|
1 | | -# 命令转 Skill 规范 v1.0 |
| 1 | +# 命令转 Skill 规范 v2.0 |
2 | 2 |
|
3 | | -> 基于 `workflow-plan` 命令转换实践提炼的标准流程 |
| 3 | +> 基于 `workflow-plan` 转换实践提炼的标准流程 |
| 4 | +> |
| 5 | +> **v2.0 变更**:命令调用引用统一转换为文件路径引用,不再保留 `/workflow:XX` 等命令调用语法 |
4 | 6 |
|
5 | 7 | ## ⚠️ 核心要求 |
6 | 8 |
|
|
70 | 72 | | ✅ 添加阶段标识 | Phase标题、来源标注 | `# Phase 1: Session Discovery` | |
71 | 73 | | ✅ 添加组织结构 | 章节标题优化 | 添加 `## Execution Steps` | |
72 | 74 | | ✅ 添加衔接说明 | Post-Phase Update | 阶段完成后的状态说明 | |
73 | | -| ✅ 移除命令调用语法 | 移除 `/workflow`、`/command` 等命令引用 | 原文 `/workflow:session:start` → 移除 | |
| 75 | +| ✅ 命令引用转文件路径 | 将 `/workflow`、`/command` 等命令引用转换为相对文件路径 | 原文 `/workflow:session:start` → `phases/01-session-discovery.md` | |
74 | 76 | | ✅ 移除 Frontmatter | 移除命令的 argument-hint、examples | 命令级元数据在 Skill 中不需要 | |
75 | 77 | | ❌ 简化代码 | 任何代码的省略或改写 | 不允许 | |
76 | 78 | | ❌ 简化Prompt | Agent Prompt的任何删减 | 不允许 | |
|
111 | 113 | - ❌ 错误:省略JSON输出示例 |
112 | 114 | - ✅ 正确:保留所有输入输出示例 |
113 | 115 |
|
114 | | -**应移除的命令特有内容**: |
| 116 | +**引用转换规则**: |
115 | 117 |
|
116 | | -转换时应移除以下命令格式专有的内容: |
| 118 | +命令引用统一转换为文件路径引用,规则如下: |
117 | 119 |
|
118 | | -| 移除内容 | 原因 | 示例 | |
119 | | -|---------|------|------| |
120 | | -| **Frontmatter** | Skill 使用 SKILL.md 的 Frontmatter | `argument-hint`、`allowed-tools`、`examples` | |
121 | | -| **命令调用语法** | Skill 使用 Phase 引用 | `/workflow:session:start` → 移除 | |
122 | | -| **命令路径引用** | 改为 Phase 路径引用 | `commands/workflow/tools/` → 移除 | |
123 | | -| **Skill 调用说明** | 在 SKILL.md 中统一说明 | `使用 /workflow:xxx 调用` → 移除 | |
124 | | -| **命令参数说明** | 仅保留执行参数 | `usage: /workflow:plan [session-id]` → 移除 | |
| 120 | +| 原命令引用 | 转换方式 | 示例 | |
| 121 | +|-----------|---------|------| |
| 122 | +| **Frontmatter** | 移除,在 SKILL.md 中统一定义 | `argument-hint`、`examples` → 移除 | |
| 123 | +| **命令调用语法** | 转换为 Phase 文件的相对路径 | `/workflow:session:start` → `phases/01-session-discovery.md` | |
| 124 | +| **命令路径引用** | 转换为 Skill 目录内路径 | `commands/workflow/tools/` → `phases/` | |
| 125 | +| **跨命令引用** | 转换为 Phase 间文件引用 | `/workflow:tools:context-gather` → `phases/02-context-gathering.md` | |
| 126 | +| **命令参数说明** | 移除或转为 Phase Prerequisites | `usage: /workflow:plan [session-id]` → Phase Prerequisites 中说明 | |
125 | 127 |
|
126 | | -**示例**: |
| 128 | +**转换示例**: |
127 | 129 |
|
128 | 130 | 原命令文件中: |
129 | 131 | ```markdown |
|
132 | 134 | - `/workflow:tools:context-gather` - Gather context |
133 | 135 | ``` |
134 | 136 |
|
135 | | -转换后Phase文件中: |
| 137 | +转换后 Phase 文件中(使用文件路径引用): |
136 | 138 | ```markdown |
137 | 139 | ## Related Phases |
138 | | -- Phase 1: Session Discovery |
139 | | -- Phase 2: Context Gathering |
| 140 | +- [Phase 1: Session Discovery](phases/01-session-discovery.md) |
| 141 | +- [Phase 2: Context Gathering](phases/02-context-gathering.md) |
140 | 142 | ``` |
141 | 143 |
|
142 | | -或直接移除相关命令说明章节,因为 SKILL.md 已包含完整的 Phase 引用表。 |
| 144 | +或在 SKILL.md 的 Phase Reference Table 中统一管理引用关系: |
| 145 | +```markdown |
| 146 | +### Phase Reference Documents |
| 147 | +| Phase | Document | Purpose | |
| 148 | +|-------|----------|---------| |
| 149 | +| Phase 1 | [phases/01-session-discovery.md](phases/01-session-discovery.md) | 会话发现与初始化 | |
| 150 | +| Phase 2 | [phases/02-context-gathering.md](phases/02-context-gathering.md) | 上下文收集 | |
| 151 | +``` |
143 | 152 |
|
144 | 153 | ### 2.2 分布读取原则 |
145 | 154 |
|
@@ -675,3 +684,4 @@ wc -l skills/{skill-name}/SKILL.md skills/{skill-name}/phases/*.md |
675 | 684 | |------|------|------| |
676 | 685 | | v1.0 | 2025-02-05 | 基于 workflow-plan 转换实践创建 | |
677 | 686 | | v1.1 | 2025-02-05 | 强化内容一致性要求;添加第7章一致性验证;添加应移除的命令特有内容说明 | |
| 687 | +| v2.0 | 2026-02-05 | 命令调用引用统一转换为文件路径引用;移除 `/workflow:XX` 命令语法;引用转换规则重构 | |
0 commit comments