Skip to content

ShenyuanNext/wepr-growth-skills / skills/dbs-skill-maker

dbs-skill-maker

Verified

通过需求分析把反复出现的问题制作成可安装、可分级验证的单个 Skill。用户要求做 Skill、把问题沉淀成 Skill、检查或测试候选 Skill 时使用;只有用户明确要求分享或发布时,才准备 GitHub 仓库并验证 `npx skills add`。

references/problem-and-goal.md

View on GitHub
# 问题契约与完成条件

当用户只有想法、功能名称或模糊愿望时读取本文件。目标是确定新 Skill 反复解决的问题,以及什么证据能够证明它完成了任务。

## 任务判断

先提取下面的变化链:

```text
使用情境 → 当前卡住的进展 → 希望发生的变化 → Skill 交付物 → 完成证据
```

使用任务陈述:

> 当我处于 `{情境}`,我想让 Agent `{推进的变化}`,以便 `{得到的结果}`。

“推进的变化”要描述状态变化。“整理资料”“写提示词”“创建 Skill”通常只是候选手段,需要继续判断用户完成后能得到什么。

## 最小问题契约

```markdown
## 问题契约

反复出现的问题:
典型使用情境:
当前方案及其稳定失败:
用户想推进的变化:
Skill 需要交付的结果:
完成证据:
可接受代价:
不处理的近邻问题:
仍待验证的事实:
```

默认用户可以参与需求分析。对问题契约、完成证据和近邻边界存在的分歧,可以邀请用户判断,并说明该判断将影响哪个 Skill 设计。缺少材料时先给“待验证假设”,继续交付当前可用版本。合并相关问题,不询问从上下文已经得到答案的内容。

## 是否值得做成 Skill

至少检查以下特征:

| 特征 | 可沉淀信号 | 暂缓信号 |
| --- | --- | --- |
| 重复性 | 同类问题会再次出现 | 完全一次性的现场任务 |
| 稳定动作 | 可以提炼判断、转换或执行动作 | 每次都依赖无法归纳的临场决定 |
| 可观察结果 | 能看到文件、动作、判断或状态 | 只能描述抽象感受 |
| 输入可得 | 必要材料和权限能够取得 | 关键事实长期不可获得 |
| 边界可写 | 能识别适用与退出条件 | 希望处理所有相邻问题 |
| 复用收益 | 下次调用能减少判断或操作成本 | 制作成本持续高于重复收益 |

不满足全部特征时,可以收窄任务。保留能稳定复用的部分,避免为单个案例生成过窄规则。

## 行为契约

问题契约已经可用后,形成:

```markdown
## 行为契约

目标任务:
预期使用条件:
输入变化范围:

必须做到:
- ...

禁止出现:
- ...

允许变化:
- ...

关键失败:
- ...
```

“必须做到”只写可观察输出或动作。“允许变化”用于保留模型对开放任务的判断空间。“关键失败”优先覆盖任务错位、安全、事实、权限和近邻边界。

## 完成条件

问题阶段可以在下面条件满足时结束:

- 下一步动作能够确定;
- 候选 Skill 的交付物能够确定;
- 用户或测试者能够识别完成;
- 近邻边界足以避免明显误触发;
- 未知项不会改变当前候选的主要结构。
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: 472kUpdated Claude CodeCodexUnverifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall