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/problem-and-goal.md
View on GitHub# 问题契约与完成条件
当用户只有想法、功能名称或模糊愿望时读取本文件。目标是确定新 Skill 反复解决的问题,以及什么证据能够证明它完成了任务。
## 任务判断
先提取下面的变化链:
```text
使用情境 → 当前卡住的进展 → 希望发生的变化 → Skill 交付物 → 完成证据
```
使用任务陈述:
> 当我处于 `{情境}`,我想让 Agent `{推进的变化}`,以便 `{得到的结果}`。
“推进的变化”要描述状态变化。“整理资料”“写提示词”“创建 Skill”通常只是候选手段,需要继续判断用户完成后能得到什么。
## 最小问题契约
```markdown
## 问题契约
反复出现的问题:
典型使用情境:
当前方案及其稳定失败:
用户想推进的变化:
Skill 需要交付的结果:
完成证据:
可接受代价:
不处理的近邻问题:
仍待验证的事实:
```
默认用户可以参与需求分析。对问题契约、完成证据和近邻边界存在的分歧,可以邀请用户判断,并说明该判断将影响哪个 Skill 设计。缺少材料时先给“待验证假设”,继续交付当前可用版本。合并相关问题,不询问从上下文已经得到答案的内容。
## 是否值得做成 Skill
至少检查以下特征:
| 特征 | 可沉淀信号 | 暂缓信号 |
| --- | --- | --- |
| 重复性 | 同类问题会再次出现 | 完全一次性的现场任务 |
| 稳定动作 | 可以提炼判断、转换或执行动作 | 每次都依赖无法归纳的临场决定 |
| 可观察结果 | 能看到文件、动作、判断或状态 | 只能描述抽象感受 |
| 输入可得 | 必要材料和权限能够取得 | 关键事实长期不可获得 |
| 边界可写 | 能识别适用与退出条件 | 希望处理所有相邻问题 |
| 复用收益 | 下次调用能减少判断或操作成本 | 制作成本持续高于重复收益 |
不满足全部特征时,可以收窄任务。保留能稳定复用的部分,避免为单个案例生成过窄规则。
## 行为契约
问题契约已经可用后,形成:
```markdown
## 行为契约
目标任务:
预期使用条件:
输入变化范围:
必须做到:
- ...
禁止出现:
- ...
允许变化:
- ...
关键失败:
- ...
```
“必须做到”只写可观察输出或动作。“允许变化”用于保留模型对开放任务的判断空间。“关键失败”优先覆盖任务错位、安全、事实、权限和近邻边界。
## 完成条件
问题阶段可以在下面条件满足时结束:
- 下一步动作能够确定;
- 候选 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 | Unverified | 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 |