ShenyuanNext/wepr-growth-skills / skills/dbs-skill-maker
dbs-skill-maker
Verified通过需求分析把反复出现的问题制作成可安装、可分级验证的单个 Skill。用户要求做 Skill、把问题沉淀成 Skill、检查或测试候选 Skill 时使用;只有用户明确要求分享或发布时,才准备 GitHub 仓库并验证 `npx skills add`。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.6 KB |
| agents/openai.yaml | config | 282 B |
| references/evaluation.md | markdown | 3.8 KB |
| references/github-publishing.md | markdown | 3.3 KB |
| references/problem-and-goal.md | markdown | 2.8 KB |
| references/skill-construction.md | markdown | 3.3 KB |
| references/theory-and-mechanism.md | markdown | 2.3 KB |
| scripts/init_skill_project.pyexecutable | script | 4.2 KB |
| scripts/prepare_github_repo.pyexecutable | script | 7.0 KB |
| scripts/validate_skill_project.pyexecutable | script | 8.2 KB |
| scripts/verify_npx_install.shexecutable | script | 2.4 KB |
references/skill-construction.md
View on GitHub# Skill 构建规范
当问题契约、行为契约和关键机制已经足够清楚,需要创建或实质修改 Skill 文件时读取本文件。
## 选择最小结构
每个 Skill 必须有 `SKILL.md`。其他目录按实际用途添加:
- `agents/openai.yaml`:Codex UI 元数据或调用策略;
- `references/`:只在特定条件下读取的规则、标准、模式和案例;
- `scripts/`:重复、确定且需要可靠执行的操作;
- `assets/`:会复制或进入最终交付的模板、图片、字体和项目骨架。
不创建空目录、占位 README、更新日志和重复说明。GitHub 打包需要安装说明时再生成 README。
## 命名与发现
- 名称使用小写英文、数字和连字符,少于 64 个字符;
- 目录名与 frontmatter `name` 一致;
- `description` 同时说明能力和使用条件;
- `description` 遵守 1~1,024 个字符规范,建议尽量控制在 300 个字符内;
- 相邻任务容易误触发时,增加一个有信息量的边界;
- 默认允许正常自动发现,用户明确要求显式调用时再关闭隐式调用。
## `SKILL.md` 写什么
主入口保留:
- 任务和产出;
- 关键不变量;
- 状态或模式选择标准;
- 必要输入和最少提问条件;
- 核心工作方式;
- 授权、停止与安全边界;
- references 和 scripts 的读取或运行条件。
入口超过约 300 行时检查是否存在可以按条件移入 reference 的大段内容。这里是上下文预算提醒,没有平台行数硬限制。
避免写入模型已经具备的通用建议、无法验证的口号、单个案例答案和对所有任务都生效的细碎规则。
## 脚本判断
满足以下任一条件时考虑脚本:
- 同一转换会反复重写;
- 文件操作需要确定结果;
- API 调用、数据处理或校验需要稳定参数;
- 纯指令执行容易漏掉关键检查。
脚本必须验证成功路径和至少一个失败路径。涉及写入、网络、发布或删除时,保留清楚的授权和停止条件。
## 初始化与交付的边界
`init_skill_project.py` 需要任务、工作动作和完成证据,以便初始文件不含空占位符。这些参数只构成候选初稿,Agent 仍需要:
1. 根据问题契约补足适用条件、边界和停止条件;
2. 删除没有改变行为的通用句子;
3. 扫描整个目录的占位符、本机绝对路径和敏感值;
4. 完成静态校验和当前能够执行的行为测试。
只有结构校验时,交付报告必须写明“行为尚未验证”。
## UI 元数据
`agents/openai.yaml` 中:
- 字符串全部加引号;
- `display_name` 使用稳定名称;
- `short_description` 简短说明独有能力;
- `default_prompt` 使用 1 句话,并显式包含 `$skill-name`;
- 只有真实依赖 MCP 工具时才声明 `dependencies`;
- 未经用户明确要求,不设置 `allow_implicit_invocation: false`。
## 完成前检查
1. `description` 能区分当前任务和近邻任务;
2. 所有相对引用真实存在;
3. scripts 已运行验证;
4. 没有未完成占位符;
5. 用户的明确选择和授权边界得到保留;
6. 私密信息没有写进可分发文件;
7. 入口只加载当前任务需要的共同信息。
使用本 Skill 自带的校验器:
```bash
python3 scripts/validate_skill_project.py /absolute/path/to/skill
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |