jsharness 1.8.2 → 1.10.0

package/.harness/skills/openspec-skill-creator/SKILL.md

@@ -0,0 +1,157 @@
+---
+name: openspec-skill-creator
+description: Skill 创建辅助技能 — 在 Harness 体系内创建新 Skill 的模板和流程，包含命名校验、Agent 关联和标准 SKILL.md 模板
+alwaysApply: false
+enabled: true
+outputPath: .harness/skills/
+---
+
+# Skill 创建辅助技能 (openspec-skill-creator)
+
+> **Skill 类型**: 工程基础设施 Skill
+> **触发场景**: 需要在 Harness 体系内创建新的 Skill
+> **所属 Agent**: developer / solution-designer
+> **输出路径**: `.harness/skills/{skill-name}/SKILL.md`
+
+---
+
+## 1. 核心职责
+
+作为 Skill 创建辅助技能，核心职责是：
+
+1. **生成符合 Harness 规范的 SKILL.md 文件**
+2. **校验 Skill 命名和冲突**
+
+### 1.1 输入
+
+| 输入项 | 说明 | 必须 |
+|--------|------|------|
+| Skill 名称 | kebab-case 格式（如 `user-profile-export`） | 是 |
+| Skill 描述 | 中文简要描述 | 是 |
+| 所属 Agent | 可调用此 Skill 的 Agent 角色 | 是 |
+| 输出路径 | Skill 产出的目标目录 | 否（有默认值） |
+
+### 1.2 输出
+
+| 输出项 | 路径 | 格式 |
+|--------|------|------|
+| SKILL.md 文件 | `.harness/skills/{skill-name}/SKILL.md` | Markdown |
+
+---
+
+## 2. 命名校验
+
+### 2.1 格式校验
+
+Skill 名称**必须**为 kebab-case 格式：
+
+- ✅ 正确：`user-profile-export`、`data-sync`、`api-gateway`
+- ❌ 错误：`UserProfileExport`、`user_profile_export`、`userProfileExport`
+
+如果用户提供的名称不符合格式，建议转换：
+- `UserProfileExport` → `user-profile-export`
+- `user_profile_export` → `user-profile-export`
+
+### 2.2 冲突校验
+
+检查 `.harness/skills/` 目录下是否已存在同名 Skill：
+- 如果存在 → 拒绝创建，报告冲突并提示已有 Skill 的路径
+- 如果不存在 → 继续创建
+
+---
+
+## 3. SKILL.md 标准模板
+
+生成的 SKILL.md 文件**必须**遵循以下模板结构：
+
+```markdown
+---
+name: {skill-name}
+description: {中文描述}
+alwaysApply: false
+enabled: true
+outputPath: {输出路径}
+---
+
+# {Skill 标题} ({skill-name})
+
+> **Skill 类型**: {类型描述}
+> **触发场景**: {何时使用}
+> **所属 Agent**: {agent-name}
+> **输出路径**: {输出路径}
+
+---
+
+## 1. 核心职责
+
+作为 {技能定位}，核心职责是：
+
+1. **{职责1}**
+2. **{职责2}**
+
+### 1.1 输入
+
+| 输入项 | 路径/说明 | 格式 | 必须 |
+|--------|----------|------|------|
+| {输入1} | {路径} | {格式} | 是 |
+
+### 1.2 输出
+
+| 输出项 | 路径/说明 | 格式 | 必须 |
+|--------|----------|------|------|
+| {输出1} | {路径} | {格式} | 是 |
+
+---
+
+## 2. 执行步骤
+
+### Step 1: {步骤1描述}
+
+{步骤1详细说明}
+
+### Step 2: {步骤2描述}
+
+{步骤2详细说明}
+
+---
+
+## 3. 约束
+
+- **{约束1}**
+- **{约束2}**
+- **所有输出使用中文**
+```
+
+---
+
+## 4. 执行步骤
+
+### Step 1: 获取 Skill 信息
+
+与用户确认：
+1. Skill 名称（kebab-case）
+2. Skill 描述（中文）
+3. 所属 Agent
+4. 输出路径（可选，默认 `.harness/doc/`）
+
+### Step 2: 执行命名校验
+
+1. 检查名称是否符合 kebab-case 格式
+2. 检查是否与已有 Skill 冲突
+
+### Step 3: 生成 SKILL.md
+
+基于标准模板生成 SKILL.md 文件，填入用户提供的信息。
+
+### Step 4: 确认
+
+展示生成的 SKILL.md 内容摘要，请用户确认。
+
+---
+
+## 5. 约束
+
+- **仅在 Harness 体系内创建** — 产出路径必须在 `.harness/skills/` 下
+- **遵循命名规范** — 名称必须 kebab-case，不得与已有 Skill 冲突
+- **遵循模板结构** — 必须包含 frontmatter、核心职责、输入输出、执行步骤、约束五个部分
+- **所有输出使用中文**