# SkillDesigner

**Repository Path**: alienity/SkillDesigner

## Basic Information

- **Project Name**: SkillDesigner
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-04
- **Last Updated**: 2026-09-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SkillDesigner

低代码式 **skill 可视化设计器**：画布设计流程（图）→ `flow.json` 唯一事实源 → 编译器产出主 agent 线性 skill。

架构与设计文档见 [FRAMEWORK.md](FRAMEWORK.md)（工程结构）与 [DESIGN.md](DESIGN.md)（设计原理）。

## 快速开始

```bash
pnpm install
pnpm -r build

# 画布（可视化设计）
pnpm dev                 # http://localhost:5180

# 命令行（无画布也能干活）
node packages/skill-compiler/dist/cli.js init my-skill --id my-skill --name 我的技能
node packages/skill-compiler/dist/cli.js lint my-skill
node packages/skill-compiler/dist/cli.js compile my-skill

# 文件/编译 API（可选，浏览器画布直接落盘）
pnpm dev:server          # http://localhost:7749

# 验收用例（分支合并：复杂条件 switch）
node packages/skill-compiler/dist/cli.js compile examples/branch-merge
```

## 编译产物（一个完整 skill 目录）

```
my-skill/
├── SKILL.md            # 生成：驱动协议 + mermaid 总览 + 步骤索引
├── flow.json           # ★ 源：唯一事实源（画布/手改/agent 改 三入口）
├── nodes/NN_*.md       # 生成：线性步骤卡（一步一卡）
├── schemas/*.json      # 生成：输出 schema
└── scripts/
    ├── nodes/*.mjs     # ★ 手写区：code 节点逻辑（export async run(state)）
    ├── gates/gate_NN.mjs  # 生成：步骤闸门（校验/路由/审计/推进）
    └── lib/*.mjs       # 生成：运行库（零依赖，node 直跑）
```

agent 按 SKILL.md 驱动协议执行：读 `state.json` 的 cursor → 读当前步骤卡 → 跑 gate → 按 `next_step` 推进。
gate 物理强制：cursor 不匹配拒绝执行、schema 不过不推进、repair 超限走 failure、循环有上限。