Skip to content

Commit 05ad811

Browse files
author
catlog22
committed
Add runtime JavaScript file for Chinese documentation build
1 parent 4258a77 commit 05ad811

93 files changed

Lines changed: 4098 additions & 137 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.claude/skills/_shared/COMMAND-TO-SKILL-CONVERSION.md

Lines changed: 27 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
1-
# 命令转 Skill 规范 v1.0
1+
# 命令转 Skill 规范 v2.0
22

3-
> 基于 `workflow-plan` 命令转换实践提炼的标准流程
3+
> 基于 `workflow-plan` 转换实践提炼的标准流程
4+
>
5+
> **v2.0 变更**:命令调用引用统一转换为文件路径引用,不再保留 `/workflow:XX` 等命令调用语法
46
57
## ⚠️ 核心要求
68

@@ -70,7 +72,7 @@
7072
| ✅ 添加阶段标识 | Phase标题、来源标注 | `# Phase 1: Session Discovery` |
7173
| ✅ 添加组织结构 | 章节标题优化 | 添加 `## Execution Steps` |
7274
| ✅ 添加衔接说明 | Post-Phase Update | 阶段完成后的状态说明 |
73-
|移除命令调用语法 | 移除 `/workflow``/command` 等命令引用 | 原文 `/workflow:session:start`移除 |
75+
|命令引用转文件路径 | `/workflow``/command` 等命令引用转换为相对文件路径 | 原文 `/workflow:session:start``phases/01-session-discovery.md` |
7476
| ✅ 移除 Frontmatter | 移除命令的 argument-hint、examples | 命令级元数据在 Skill 中不需要 |
7577
| ❌ 简化代码 | 任何代码的省略或改写 | 不允许 |
7678
| ❌ 简化Prompt | Agent Prompt的任何删减 | 不允许 |
@@ -111,19 +113,19 @@
111113
- ❌ 错误:省略JSON输出示例
112114
- ✅ 正确:保留所有输入输出示例
113115

114-
**应移除的命令特有内容**
116+
**引用转换规则**
115117

116-
转换时应移除以下命令格式专有的内容
118+
命令引用统一转换为文件路径引用,规则如下
117119

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 中说明 |
125127

126-
**示例**
128+
**转换示例**
127129

128130
原命令文件中:
129131
```markdown
@@ -132,14 +134,21 @@
132134
- `/workflow:tools:context-gather` - Gather context
133135
```
134136

135-
转换后Phase文件中
137+
转换后 Phase 文件中(使用文件路径引用)
136138
```markdown
137139
## 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)
140142
```
141143

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+
```
143152

144153
### 2.2 分布读取原则
145154

@@ -675,3 +684,4 @@ wc -l skills/{skill-name}/SKILL.md skills/{skill-name}/phases/*.md
675684
|------|------|------|
676685
| v1.0 | 2025-02-05 | 基于 workflow-plan 转换实践创建 |
677686
| v1.1 | 2025-02-05 | 强化内容一致性要求;添加第7章一致性验证;添加应移除的命令特有内容说明 |
687+
| v2.0 | 2026-02-05 | 命令调用引用统一转换为文件路径引用;移除 `/workflow:XX` 命令语法;引用转换规则重构 |

0 commit comments

Comments
 (0)