# Skillforge

> Skill生成工厂 — 从任意意图，通过七步元认知（搜/分/叠/展/衡/验/成），推导出完整 Skill 架构。

- **Type:** Skill
- **Install:** `agentstack add skill-boshen99-skillforge-skillforge`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [boshen99](https://agentstack.voostack.com/s/boshen99)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [boshen99](https://github.com/boshen99)
- **Source:** https://github.com/boshen99/skillforge

## Install

```sh
agentstack add skill-boshen99-skillforge-skillforge
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# SkillForge

> **一句话**：给我一个意图，还你一个完整 Skill
> **七步元认知**：搜→分→叠→展→衡→验→成
> **中文版**：原理→PRINCIPLES.md，配方→RECIPES.md
> **English**: Principles→PRINCIPLES_en.md, Recipes→RECIPES_en.md

---

## 触发条件

```
当说出以下类型的意图时，进入七步推导：
  "我想做一个xxx"
  "能不能加一个xxx功能"
  "xxx应该怎么做"

Step 0（第零步）永远先走：
  搜"[你的意图] + Claude Skill" / "xxx workflow" / "xxx AI automation"
  搜到了 → 学习它的工具/流程/异常/阈值，再推导
  没搜到 → 确认空白，从零推导
```

---

## 七步推导总览

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
步骤   操作   问什么问题           输出什么
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
0      搜     网上有没有类似的？   学习工具/流程/异常/阈值
1      分     AI最容易做什么过头？  阴阳（做/不做）
2      叠     需要什么家伙？       四力（工具/任务/判断/门控）
3      展     这个Skill在哪？      八卦（输入/输出/边界/流向等）
4      衡     传导链断了吗？       五行（金→木→火→水→土）
5      验     有没有断点？         回头补（补到不断为止）
6      成     推导完成了吗？        完整Skill ✓
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

## 快速推导（5分钟版）

```
第零步：搜（1分钟）
  搜"_____ Claude skill" / "_____ workflow" / "_____ AI automation"
  搜到了？→ 学它的工具/流程/异常/阈值
  没搜到？→ 确认空白，从零推导

第一步：分阴阳（1分钟）
  AI最容易在___上做过头 → ✗ 禁止1
  ___属于上游/下游范围  → ✗ 禁止2
  ___必须留给人类判断   → ✗ 禁止3
  阳面：这个Skill要___   → 做1/做2/做3

第二步：叠四力（1分钟）
  太阳（工具）：___（工具）___（工具）___（工具）
  少阳（任务）：Step1 → Step2 → Step3
  少阴（判断）：判断1：___？  判断2：___？
  太阴（门控）：□ 完成标准1  □ 完成标准2

第三步：展八卦（1分钟，最少3个）
  乾（输入）：___     坤（输出）：___
  艮（边界）：___     巽（流向）：___

第四步：衡五行（30秒）
  金→木→火→水→土 哪一环断了？→ 回头补

第五步：验（30秒）
  木（方向）：扩展预设是否已定义？
  火（判断）：判断依据是否充分？判断是否过度僵化/松散？
  土（沉淀）：产出是否有冗余？
  金（结构）：边界是否过度僵化/松散？
  水（流动）：流动是否阻塞/过度发散？

第六步：成 ✓
  分✓ 叠✓ 展✓ 衡✓ 验✓ 成✓
```

---

## 质量检查（收口用）

```
□ 搜：搜过现有 Skill（搜了/没搜到/确认空白）
□ 分：禁止 >= 3 条
□ 叠：工具有 3-10 个，任务有序，判断有量化阈值
□ 展：至少填了乾（输入）+ 坤（输出）+ 艮（边界）
□ 衡：金→木→火→水→土 传导链不断
□ 验：木/火/土/金/水 五力各问过了，没有明显失衡
□ 成：分✓ 叠✓ 展✓ 衡✓ 验✓ 成✓
□ 扩展预设：扩展方向 + 扩展规则 + 扩展门控都有
```

---

## 配套文件

| 文件 | 用途 |
|------|------|
| PRINCIPLES.md | 七步元认知详解 + 推导规则 + 完整实例 |
| RECIPES.md | 五种快捷入口（5分钟版） |
| PRINCIPLES_en.md | Seven Meta-Cognitive Operations（English） |
| RECIPES_en.md | Five Entry Points（English） |

---

## 七、生成质量验收（强制执行）

skillforge 生成的 SKILL.md 必须通过以下质量验收，否则必须返工。

### 验收标准（10项，每项10分，满分100）

| # | 维度 | 评审问题 | 合格线 |
|---|------|---------|--------|
| 1 | 技能边界 | 是否明确写了「做什么」和「不做什么」？禁止行为是否具体可执行？ | ≥8 |
| 2 | 术语定义 | 所有专业词汇是否在前3节定义？是否有歧义词？ | ≥8 |
| 3 | 输入输出 | JSON格式/数据路径/数据类型是否明确给出？ | ≥8 |
| 4 | Pipeline 可执行性 | 步骤是否有编号？阈值是否量化（非"适当""合理"）？ | ≥8 |
| 5 | 质量门控 | 告警触发条件是否明确？是否区分致命/严重/警告？ | ≥8 |
| 6 | Skill 关系 | 上下游 Skill 是否标注？调用关系是否写明？ | ≥7 |
| 7 | 禁止行为 | 是否覆盖 AI 最容易越界的场景（如改上游原始输入、替下游填结论）？ | ≥8 |
| 8 | JSON 输出格式 | 是否给出具体 JSON 结构示例（非伪代码）？ | ≥7 |
| 9 | 版本历史 | 是否有版本变更记录？格式是否规范？ | ≥6 |
| 10 | 可读性 | 是否无空洞形容词（"赋能""抓手"等）？是否无歧义表达？ | ≥7 |

**总分合格线：80/100**
**致命项（=80 else '✗ 不通过'}
    达标项：{≥8分的项}
    需修复：{5-7分的项}
    不合格：{<5分的项}
    致命项：{0分的项}
```

### 常见不合格模式（快速自检）

```
✗ 致命：缺少禁止行为清单
✗ 致命：输入输出用"按规范输出"代替具体格式
✗ 致命：阈值写"适当""合理"而非具体数值
✗ 严重：技能边界写"负责X相关工作"（太模糊）
✗ 严重：与其他 Skill 关系写"调用相关 Skill"（未指明是哪个）
✗ 严重：版本历史只写"更新"无具体变更内容
```

---

## 八、版本历史

| 版本 | 日期 | 变更 |
|------|------|------|
| v5.5 | 2026-04-22 | 新增第七步：生成质量验收（10项标准、验收流程、不合格模式清单），确保生成即合规 |
| v5.4 | 2026-04-09 | 快速推导：验步骤改为五行标签格式；SKILL.md 自相矛盾（步骤数）统一为七步；成步骤"够了吗？"改为"推导完成了吗？" |
| v5.3 | 2026-04-08 | PRINCIPLES_en.md 英文版完整重写对齐 v5.3（七步+Step0）；SKILL.md 自相矛盾修复 |
| v5.2 | 2026-04-08 | 新增扩展预设：推导时预设扩展方向+扩展规则+扩展门控 |
| v5.1 | 2026-04-08 | 新增第零步：搜，推导前先联网调研现有 Skills |

---

*本文档由 skillforge 提供 — 给你元认知，不给你规则库*

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [boshen99](https://github.com/boshen99)
- **Source:** [boshen99/skillforge](https://github.com/boshen99/skillforge)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-boshen99-skillforge-skillforge
- Seller: https://agentstack.voostack.com/s/boshen99
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.