az-skills — 通用智能体技能

一个技能定义，在所有智能体上原生运行。 One skill definition, native on every agent.

我叫啊这，你的朋友兼军师。

---

⚠️ 测试项目 — 本项目主要用于实验 AgentOS 概念，验证"一个 Skill 定义适配所有智能体"的方案可行性。非生产就绪。

---

安装

在 Claude Code 中使用（推荐）

# 克隆项目
git clone https://github.com/aiad-world/az-skills.git ~/.claude/skills/az-skills

# 或只安装单个技能
cp -r az-skills/skills/first-date/claudecode ~/.claude/skills/first-date

在 OpenClaw / Hermes / Codex 中使用

每个 skill 目录下的对应平台文件夹包含原生格式文件，按各平台机制加载即可：

skills/<skill-name>/
├── openclaw/plugin.json    →  OpenClaw 插件
├── hermes/tool.yaml        →  Hermes 工具定义
└── codex/action.yaml       →  Codex Action

---

项目说明

az-skills 是 AgentOS 的实验场。核心命题：

能否让一个 Skill 定义在 Claude Code、OpenClaw、Hermes、Codex 等多个智能体上原生运行，且不丢失人格和场景感？

核心理念

• 场景优先（Scene-First） — 技能围绕真实生活场景组织（约会、创作、上镜），不是围绕 workflow
• 朋友不是工具 — 我叫啊这，在任何技能里都是你的朋友。性格随场景变，但关心你不会变
• 走出去 — 目的不是让你留在 Agent 里聊天，而是让你自信地参与现实生活
• 一次编写，到处运行 — 不造新平台，一个标准格式适配所有智能体

技术栈

层	技术
技能定义	YAML (通用格式)
适配器引擎	Node.js (core.js)
平台输出	SKILL.md / plugin.json / tool.yaml / action.yaml
Schema	JSON Schema

---

项目结构

az-skills/
├── schema/
│   └── skill-schema.json        # 通用技能标准格式（JSON Schema）
├── skills/                      # 技能定义（通用 YAML + 各平台原生格式）
│   ├── first-date/              # ⭐ 第一次约会出场设计
│   ├── character-debut/         # ⭐ 角色第一次出场视觉方案
│   └── on-camera/               # ⭐ 上镜/录视频出场设计
├── adapters/                    # 格式转换引擎
│   ├── core.js                  # 核心转换脚本
│   ├── package.json
│   └── node_modules/
├── gofun/                       # 原始概念文档
└── README.md

每个 skill 目录下包含：

skills/<skill-name>/
├── skill.yaml              # 通用定义（源文件）
├── claudecode/SKILL.md     # Claude Code 原生格式
├── openclaw/plugin.json    # OpenClaw 原生格式
├── hermes/tool.yaml        # Hermes 原生格式
└── codex/action.yaml       # Codex 原生格式

首批技能

技能	朋友	场景	传播性
第一次约会出场设计	啊这（温暖军师）	第一次约会的穿搭、气质、策略	⭐⭐⭐⭐⭐
角色第一次出场视觉方案	啊这（冷静搭档）	小说/漫画/游戏角色视觉设计	⭐⭐⭐⭐⭐
上镜/录视频出场设计	啊这（犀利指导）	短视频/直播造型策略	⭐⭐⭐⭐

从通用格式生成平台文件

cd adapters
npm install
node core.js ../skills/first-date
node core.js ../skills/character-debut
node core.js ../skills/on-camera
# 或一次性生成所有
npm run build:all

通用格式（skill.yaml）

每个技能的核心定义是一个 YAML 文件，包含：

• persona — 技能作为"朋友"的人格（名字、性格、语气、第一轮侵入行为）
• scene — 适用场景和入口问题
• inputs — 需要向用户收集的信息
• output — 输出规格
• adapters — 各平台适配器配置

详见图式：schema/skill-schema.json

架构

┌──────────────────────────────────────────────┐
│             技能定义层（skill.yaml）              │
│  场景优先 + 朋友人格 + 输入输出规范                │
├──────────────────────────────────────────────┤
│         适配器层（core.js）                     │
│  claudecode / openclaw / hermes / codex      │
├──────────────────────────────────────────────┤
│         运行时（每个平台的原生机制）               │
│  Claude Code Skills / OpenClaw Plugins / ... │
└──────────────────────────────────────────────┘

贡献

1. Fork 本仓库
2. 在 skills/ 下创建新 skill（参考现有 skill.yaml 格式）
3. 运行 cd adapters && npm run build:all 生成平台文件
4. 提交 PR

联系方式

• 微信：wwwr600a
• Twitter：@ADfunAI

许可证

MIT

关联

• METHODOLOGY.md — HUMAN3.0 用户理解框架 & Karpathy LLM Wiki 知识审计
• Scene-First Skill System 概念 — 原始思考（啊这的诞生之地）
• AgentOS — 本项目的实验母体

---

让每个人在重要时刻，都有一个朋友帮你参谋怎么出现。