技能创造
- 作者仓库星标 549
- 作者仓库 bkit-claude-code
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @popup-studio-ai · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- Python
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
第 4 步:生成 Eval 文件(可选)
使用以下内容创建 `evals/{name}/` 目录: eval.yaml 格式:
# skill-create - Interactive Skill Creation Workflow
프로젝트 컨텍스트를 분석하여 project-local 스킬을 생성하는 워크플로우.
## Workflow Steps
### Step 1: Gather Information
If `/skill-create` (no args):
1. Ask user for skill name (kebab-case)
2. Ask user for skill purpose/description
3. Ask user for classification: workflow or capability
If `/skill-create {name}`:
1. Use provided name
2. Analyze project context to infer purpose
3. Ask user to confirm/modify
If `/skill-create from-btw {btw-id}`:
1. Read btw suggestion from `.bkit/btw-suggestions.json`
2. Use suggestion text as seed for skill description
3. Use suggestion context for project context
### Step 2: Analyze Project Context
1. Read `CLAUDE.md` for project conventions
2. Scan project structure:
- Identify tech stack (Java/Spring, Next.js, Python, etc.)
- Find relevant patterns in source code
- Check existing project-local skills for overlap
3. Determine appropriate:
- Allowed tools for the skill
- Trigger keywords (Korean + English)
- Related files/patterns to reference
### Step 3: Generate SKILL.md
Create `.claude/skills/project/{name}/SKILL.md` with:
```yaml
---
name: {name}
classification: {workflow|capability}
classification-reason: "{reason based on analysis}"
deprecation-risk: none
effort: low
description: |
{Generated description}
Triggers: {trigger commands}
Keywords: {keywords in Korean and English}
argument-hint: "{usage hint}"
user-invocable: true
allowed-tools:
- Read
- Write
- Edit
- Glob
- Grep
- Bash
---
```
Body content includes:
- Purpose and when to use
- Step-by-step instructions for workflow skills
- Pattern reference for capability skills
- Code examples from actual project files
- Integration points with other skills
### Step 4: Generate Eval Files (optional)
Create `evals/{name}/` directory with:
```
evals/{name}/
eval.yaml - Test configuration
prompt.txt - Test prompt
expected.txt - Expected behavior description
```
**eval.yaml format:**
```yaml
name: "{name} skill eval"
skill: ".claude/skills/project/{name}/SKILL.md"
tests:
- name: "basic trigger"
prompt: "{trigger command}"
expected:
- "{expected behavior 1}"
- "{expected behavior 2}"
- name: "edge case"
prompt: "{edge case prompt}"
expected:
- "{expected behavior}"
```
### Step 5: Confirm and Report
1. Show generated file paths
2. Show skill summary (name, classification, triggers)
3. Suggest: "Test with `/{name}` or review at `.claude/skills/project/{name}/SKILL.md`"
## Project-Local Skill Location
All generated skills go to: `.claude/skills/project/{name}/SKILL.md`
This location:
- Is git-trackable for team sharing
- Takes precedence over bkit core skills (2-layer architecture)
- Is auto-loaded by Claude Code's skill discovery
## Naming Conventions
| Pattern | Example | Use When |
|---------|---------|----------|
| `{project}-{domain}` | `hunikflow-model` | Domain-specific capability |
| `{action}-{target}` | `validate-entity` | Action-oriented workflow |
| `{tool}-{purpose}` | `proxy-guide` | Tool/pattern guide |
## From-BTW Integration
When creating from a /btw suggestion:
1. Read the suggestion's `context.file` to understand what code was being worked on
2. Read the suggestion's `context.feature` to understand the PDCA feature context
3. Use suggestion text as the primary description seed
4. After creation, update the btw suggestion's `promotedTo` field with the new skill name
章节与文件索引
按说明文件中的顺序排列。
第 1 步:收集信息
第 2 步:分析项目背景
第3步:生成SKILL.md
第 4 步:生成 Eval 文件(可选)
第5步:确认并报告
文件/命令 -> /skill-create · /skill-create {name} · /skill-create from-btw {btw-id} · .bkit/btw-suggestions.json · CLAUDE.md · .claude/skills/project/{name}/SKILL.md · evals/{name}/ · /{name}
内容校验值 -> 60c6621af27c
当前原文的自动摘译,尚未人工审校。
第 1 步:收集信息
如果
/skill-create(无参数):询问用户技能名称(短横线大小写) 询问用户技能目的/描述 询问用户分类:工作流程或能力 如果/skill-create {name}:第 2 步:分析项目背景
阅读
CLAUDE.md了解项目约定 扫描项目结构:识别技术堆栈(Java/Spring、Next.js、Python 等) 在源代码中查找相关模式 检查现有项目本地技能是否重叠第3步:生成SKILL.md
创建
.claude/skills/project/{name}/SKILL.md: 正文内容包括: 目的和何时使用 工作流程技能的分步说明 能力技能的模式参考第 4 步:生成 Eval 文件(可选)
创建
evals/{name}/目录: eval.yaml 格式:第5步:确认并报告
显示生成的文件路径 显示技能摘要(名称、分类、触发器) 建议:“使用
/{name}进行测试或在.claude/skills/project/{name}/SKILL.md进行审查”