Skip to content

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

dbs-skill-maker

Verified

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

references/theory-and-mechanism.md

View on GitHub
# 理论与机制设计

当问题已经清楚,但 Skill 的关键判断缺少可靠机制、适用条件或反证方式时读取本文件。

理论只服务于具体动作。一个理论、行业标准或经验规则进入 Skill,需要改变至少一项:判断顺序、分类标准、中间产物、适用边界或验证方法。

## 先拆判断动作

```markdown
| 判断动作 | 输入 | 需要得到的中间结果 | 缺少它会发生什么错误 |
| --- | --- | --- | --- |
```

常见动作包括:定义、归类、找因果、识别任务、分层、比较方案、找反例、生成方案、验证现实、决定停止。

## 机制候选

每个动作提出最少数量的候选机制:

```markdown
| 动作 | 候选理论/规则/工具 | 为什么适合 | 可能失效的条件 | 核实状态 |
| --- | --- | --- | --- | --- |
```

优先级:

1. 用户已经验证的现实规则或明确行业标准;
2. 能直接解释当前判断动作的可信理论;
3. 多个独立案例反复出现的条件性机制;
4. 可证伪、可替换的暂定假设。

名人辨识度和术语新鲜感不能单独构成入选理由。

## 核实要求

外部事实会改变 Skill 的判断时才进行外部研究。优先使用原著、原始论文、官方标准和权威机构材料。无法核实原始来源时标注权威二手来源或尚未核实,不猜测作者、年份、引文和页码。

研究简单问题时保留:

- 1 个主机制;
- 0~2 个补充机制;
- 至少 1 个纠偏方向或失败边界。

候选很多时,根据机制匹配、来源可靠、能否导出行为、边界清晰度和信息增量筛选。

## 映射到 Skill

```markdown
| Skill 步骤 | 使用机制 | 输入 | 输出 | 拦截的错误 | 失效边界 |
| --- | --- | --- | --- | --- | --- |
```

每个机制必须落到具体步骤。多个机制可以顺序执行、并行分析或分层检验,需要说明中间结果怎样传递。

## 小样本试跑

将候选机制用于一个真实片段,记录:

- 试跑输入;
- 每一步产生的中间判断;
- 比常识新增的判断;
- 能导出的行动;
- 能够推翻它的信号。

跑不出新判断、无法导出行动或无法设置失败信号的机制,从候选 Skill 中删除。理论研究结束后只把实际改变 Agent 行为的部分写入 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 CodeCodexVerifiedInstall
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: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated 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: 323kUpdated Claude CodeCodexVerifiedInstall