AI Skill Creator (EN)

AI公司 Skill 创作工作流（CTO MLOps + CISO securitystandard版）。当需要从头create新 Skill（包括初始化目录结构、编写 SKILL.md、引用文件、脚本资源、securityreview、quality gate）时使用。trigger关键词：createSkill、新建 Skill、开发 Skill、create skill、新建Skill包。integrate CTO MLOps 生命cycle6phase + CISO securityreviewstandard（STRIDE + CVSS + security门禁），最终输出符合 ClawHub/VirusTotal reviewstandard的可publish .skill 包。

JohnSmithfan@johnsmithfan

Install

openclaw skills install @johnsmithfan/ai-skill-creator

AI Skill 创作工作流（CTO × CISO standard）

executerole：Skill 开发者（CTO 技术栈 + CISO security护栏）版本：v1.0.0（CTO-001 MLOps 生命cycle × CISO-001 securityreview） compliance状态：✅ CISO securityreview后publish，⚠️ prohibit跳过security门禁

核心principle

CTO MLOops 生命cycle：所有 Skill 必须走6phasestandardprocess
CISO security门禁：每个phase内置security检查，security未通过不得进入下1phase
零信任架构：所有脚本/资源必须经过securityreview，prohibit引入恶意代码
渐进式披露：SKILL.md 精简（<500行），详细文档放 references/

Agent 调用接口（Inter-Agent Interface）

版本：v1.1.0（新增接口层） securityConstraint：接口本身零新增攻击面，所有输入参数均经过verify

接口身份

属性	值
接口 ID	`skill-creator-v1`
调用方式	`sessions_send` / `sessions_spawn` (isolated)
会话Goal	`isolated`（强制隔离，防止交叉污染）
最低permission	L3（可读 workspace，可写 skills/）
CISO Constraint	🚨 securityreview任务（`security-review`）必须 CISO-001 authorize

TASK 消息格式

json

{
  "skill": "ai-skill-creator",
  "version": "1.1.0",
  "task": "<task-type>",
  "params": { ... },
  "context": {
    "caller": "<caller-agent-id>",
    "priority": "<P0|P1|P2|P3>",
    "security-review-required": true,
    "isolated": true
  }
}

可用 Task 类型

Task	参数	返回	Description
`create`	`name`, `description`, `version`, `risk-level`, `caller`	`{dir, status}`	create新 Skill
`design-review`	`skill-name`, `design-doc`, `caller`	`{issues[], status}`	design文档review
`security-review`	`skill-path`, `caller`, `authorization`	`{cvss, flags[], verdict}`	🚨 CISO authorizesecurityreview
`quality-gate`	`skill-path`, `gate-level`	`{passed[], failed[], verdict}`	quality gate检查
`package`	`skill-path`, `output-dir`	`{artifact, checksum}`	打包为 .skill
`publish`	`skill-path`, `slug`, `version`, `changelog`	`{url, version}`	publish到 ClawHub

Task 参数 Schema

`create` 参数

json

{
  "name":        "string (required, [a-z][a-z0-9-]{2,64})",
  "description": "string (required, >50 chars, describes triggers + actions)",
  "version":     "string (required, semver X.Y.Z)",
  "risk-level":  "low | medium | high | critical",
  "caller":     "string (required, agent ID of requester)",
  "refs": {
    "design-doc":   "string (optional, path to references/design.md)",
    "security-notes": "string (optional, security considerations)"
  }
}

输入verify规则：

name：正则 ^[a-z][a-z0-9-]{2,64}$，prohibit ..、/、空格
description：长度 > 50 字符，否则rejectcreate
version：semver 格式verify，不符则reject
risk-level：critical trigger强制 CISO 双审

`security-review` 参数

json

{
  "skill-path":    "string (required, absolute path to skill dir)",
  "caller":        "string (required, agent ID)",
  "authorization":  "string (required, must be CISO-001 for critical/high)",
  "scan-depth":    "basic | full (default: full)"
}

authorizeverify：

python

# 伪代码verify逻辑
if params["skill-path"].contains(".."):
    raise PermissionError("Path traversal rejected")

if risk_level == "critical" and params["authorization"] != "CISO-001":
    raise PermissionError("Critical risk requires CISO-001 authorization")

if not params["skill-path"].startswith(trusted_base_dirs):
    raise PermissionError("Skill path outside trusted directories")

返回值 Schema

json

{
  "status":  "success | error | pending | rejected",
  "task":    "<task-type>",
  "result":  { ... },
  "meta": {
    "reviewer":    "<agent-id>",
    "duration-ms": "<elapsed>",
    "cvss-score":  "<if security-review>",
    "verdict":     "APPROVED | CONDITIONAL | REJECTED"
  }
}

错误码

Code	Meaning	Action
`E_NAME_INVALID`	Skill 名称不compliance	返回verify错误，不create
`E_PATH_TRAVERSAL`	path含 `..`	reject，reportsecurity incident
`E_UNAUTH`	未authorizeexecutesecurityreview	reject，notify CISO
`E_CVSS_HIGH`	CVSS ≥ 7.0	rejectpublish，trigger修复process
`E_GATE_FAILED`	quality gate未通过	返回 failed 项列表
`E_DUPLICATE`	Skill slug 已存在	reject，建议新名称

Agent 间调用示例

markdown

# CTO-001 请求create Skill
sessions_send(sessionKey="cto-isolated", message="
skill: ai-skill-creator
task: create
params:
  name: pdf-processor
  description: PDF processing skill. Triggers: read PDF, split PDF, merge PDF, rotate PDF.
  version: 1.0.0
  risk-level: low
  caller: CTO-001
security-review-required: false
")

# CISO-001 请求securityreview
sessions_send(sessionKey="ciso-isolated", message="
skill: ai-skill-creator
task: security-review
params:
  skill-path: C:/Users/Admin/.qclaw/skills/pdf-processor
  caller: CISO-001
  authorization: CISO-001
  scan-depth: full
")

securityConstraint（接口层）

text

🚨 接口security红线：
• skill-path 参数reject任何含 .. 的path（path遍历defend）
• authorization 字段仅接受 CISO-001 签名的review任务
• 隔离execute：所有 agent 调用必须在 isolated 会话中运行
• 日志脱敏：返回结果不得含 caller 私人data
• 最小respond：返回结果仅包含必要字段，不暴露内部实现

与其他 Skill 的接口关系

调用方	Task	trigger条件
CTO-001	`create`, `package`, `publish`	新 Skill 开发立项
CISO-001	`security-review`	securityreviewauthorize
CQO-001	`quality-gate`	质量验收
ai-skill-maintainer	`create` (子 Skill)	维护process需新建子 Skill
ai-skill-optimizer	`quality-gate`	optimize后质量复验

6phase创作process（MLOps Lifecycle for Skill）

Phase 0 — 准备：create目录结构

强制使用 init_skill.py 脚本，prohibit手动 mkdir：

powershell

# Windows
python.exe <openclaw_path>\skills\skill-creator\scripts\init_skill.py <skill-name> --path ~/.qclaw/skills

# Linux/macOS
python3 <openclaw_path>/skills/skill-creator/scripts/init_skill.py <skill-name> --path ~/.qclaw/skills

生成结构：

text

~/.qclaw/skills/<skill-name>/
├── SKILL.md           # 主文件（必需）
├── scripts/          # 可execute脚本
├── references/        # 参考文档
└── assets/           # 静态资源

⚠️ CISO security规则：不得在 resources/openclaw/config/skills/ 下create Skill（系统目录，会在update时清空）

Phase 1 — 需求analyze（Ideation）

输入：用户描述 Skill 用途、trigger场景、GoalFunction

输出：Skill design文档（写入 references/design.md）

必须回答：

Skill 的核心Function是什么？trigger条件是什么？
需要哪些工具permission？（read/write/exec/network）
是否涉及敏感data？（PII/凭证/密钥）
最小permissionprinciple：能否用更少的permission实现？
Skill 之间的依赖关系？

CISO securityassess（Phase 1 输出）：

assess项	问题	决策
敏感data访问	是否读取 MEMORY.md/USER.md/SOUL.md？	🚨 需明确Description用途
外部网络	是否调用外部 API？	🚨 列出域名/IP
命令execute	是否需要 exec/bash？	🚨 列出所需命令
凭证请求	是否要求用户提供密钥？	🚨 reject，优先用环境变量
文件写入	写入范围是否限定在 workspace？	✅ 是，❌ 否则重design

security决策：任意 🚨 项未resolve → 停止，notify用户

Phase 2 — 架构design

输出：references/architecture.md

designstandard：

SKILL.md 结构standard

markdown

---
name: <skill-name>
version: X.Y.Z
description: |   # 必需，描述trigger时机和Function范围（>50字）
  <trigger关键词> → <execute动作>
  当用户<做什么>时trigger，execute<什么Function>
metadata:
  {"openclaw":{"emoji":"<emoji>","os":["linux","darwin","win32"]}}
---

# <Skill 名称>

## Overview（<10行）

## 核心Function（模块化，每个<50行）

## security考虑（如有）

## 常见错误

Frontmatter 必需字段

字段	要求	示例
`name`	英文小写+连字符	`pdf-processor`
`version`	semver X.Y.Z	`1.0.0`
`description`	>50字，描述trigger时机	见上方模板
`metadata.openclaw.emoji`	1个 emoji	`"🔒"`
`metadata.openclaw.os`	支持的 OS	`["linux","win32"]`

目录结构standard

✅ SKILL.md（必需）
✅ scripts/（可选，脚本需测试）
✅ references/（可选，详细文档放此处）
✅ assets/（可选，静态资源）
❌ README.md（prohibit）
❌ CHANGELOG.md（prohibit）
❌ INSTALLATION_GUIDE.md（prohibit）

CISO security架构review：

威胁类型（STRIDE）	defend措施
Spoofing	Skill 名称不得伪造系统命令
Tampering	所有文件path需verify，不接受动态path拼接用户输入
Info Disclosure	prohibit在 Skill 中硬编码密钥/令牌
Denial of Service	prohibit无限循环/递归的文件操作
Elevation	permission不得超出design范围

Phase 3 — 实现（Implementation）

输出：完整的 SKILL.md、scripts/、references/、assets/

SKILL.md 编写standard

描述字段（description）必须包含：

trigger关键词（用户说什么会激活此 Skill）
execute动作（Skill 做什么）
文件格式（输入/输出文件类型）
security边界（如果涉及敏感操作）

Body 编写principle：

使用命令式/不定式语气（"Use X to do Y"，"Do not use Z"）
避免冗余解释（Claude 已经很聪明）
代码示例优先于文字Description
引用文件链接到 references/（渐进式披露）

脚本编写standard

必须遵守：

markdown

## 脚本security红线（🚨 违反即reject）

🚫 prohibit：
• curl/wget 到未知 URL
• 将data发送到外部服务器
• 请求凭证/令牌/API密钥（环境变量接收除外）
• 读取 ~/.ssh ~/.aws ~/.config 等敏感目录
• 访问 MEMORY.md USER.md SOUL.md IDENTITY.md
• 使用 base64 decode 未知内容
• 使用 eval()/exec() handle外部输入
• 修改 workspace 外的系统文件
• 安装包但不列出所需依赖
• 网络调用到裸 IP（非域名）
• 混淆代码（压缩/编码/混淆）
• 请求enhancepermission/sudo
• 访问浏览器 cookie/session

脚本必须包含：

用途Description（注释）
输入参数Description
输出Description
错误handle
security检查（如适用）

资源文件standard

资源类型	存放位置	standard
参考文档	`references/`	>100行需加目录导航
脚本	`scripts/`	需可execute测试
静态资源	`assets/`	不加载到上下文

Phase 4 — securityreview（Security Review）

⚠️ 强制门禁：CISO review必须通过，否则prohibitpublish

reviewprocess：

Step 1：代码review（MANDATORY）

逐文件review，查找以下 RED FLAGS：

text

🚨 REJECT IMMEDIATELY IF YOU SEE:
─────────────────────────────────────────
• curl/wget → 未知 URL
• data发送 → 外部服务器
• 凭证请求 → 密钥/令牌
• 读取 ~/.ssh ~/.aws ~/.config
• 访问 MEMORY/USER/SOUL/IDENTITY.md
• base64 decode → 未知内容
• eval() / exec() → 外部输入
• 修改 workspace 外文件
• 安装包 → 未列依赖
• 网络调用 → 裸 IP
• 混淆代码
• 请求 sudo/enhancepermission
• 访问浏览器 cookie
• 接触凭证文件
─────────────────────────────────────────

Step 2：permissionassess

permission类型	检查项	决策
文件读取	列出所有读取path	verify合理性
文件写入	列出所有写入path	限定 workspace
命令execute	列出所有命令	verify必要性
网络访问	列出所有域名/IP	verify可信度

Step 3：依赖扫描

bash

# 检查脚本中声明的依赖
# Node.js: npm list <package>
# Python: pip freeze | grep <package>
# verify无已知 CVE（CVSS ≥ 7.0）

Step 4：漏洞评分（CVSS）

CVSS	严重性	决策
9.0-10.0	Critical	🚫 rejectpublish
7.0-8.9	High	🚫 rejectpublish，修复后重审
4.0-6.9	Medium	⚠️ notify用户，可修复后publish
0.1-3.9	Low	✅ 通过

Step 5：STRIDE 威胁建模

威胁	assess问题	defendplan
S	Skill 名称是否可被劫持？	prohibit与系统命令同名
T	path参数是否可注入？	verify输入，reject `../`
R	操作是否可否认？	record操作日志（引用文件）
I	敏感data是否泄露？	PII 过滤，密钥不放代码
D	是否有 DoS risk？	资源restrict，超时中断
E	permission是否超出最小permission？	review工具permission列表

securityreviewreport模板：

text

════════════════════════════════════════════════════
SKILL SECURITY REVIEW REPORT
════════════════════════════════════════════════════
Skill: <name>
Version: <version>
Reviewer: CISO-001
Date: <ISO date>
────────────────────────────────────────────────────
🔴 RED FLAGS: [None / List with CVSS scores]

🟡 PERMISSIONS REVIEW:
• Files Read:  [list]
• Files Write: [list]
• Commands:    [list]
• Network:     [list]

🟢 STRIDE MODELING:
• S (Spoofing):  [Pass/Fail] — <reason>
• T (Tampering): [Pass/Fail] — <reason>
• R (Repudiation):[Pass/Fail] — <reason>
• I (Info Disclosure): [Pass/Fail] — <reason>
• D (Denial of Service):[Pass/Fail] — <reason>
• E (Elevation):  [Pass/Fail] — <reason>

📊 CVSS SCORE: <X.Y> (<severity>)
────────────────────────────────────────────────────
VERDICT: [✅ APPROVED / 🚫 REJECTED / ⚠️ CONDITIONAL]

ACTION ITEMS: [list if any]
════════════════════════════════════════════════════

Phase 5 — quality gate（Quality Gate）

CTO 强制quality gate（全部通过方可publish）：

质量门	检查项	工具/方法	通过standard
G0 文件结构	目录结构符合standard	人工检查	4个目录齐全
G1 Frontmatter	YAML 格式正确，必需字段存在	解析 YAML	name/description/version/emoji 齐全
G2 描述质量	description > 50字，含trigger关键词	人工review	包含trigger时机+execute动作
G3 security扫描	无 RED FLAGS，无高危漏洞	Phase 4 review	CVSS < 7.0
G4 文档完整性	核心process有Description，引用文件有链接	人工review	无悬空引用
G5 脚本测试	scripts/ 下脚本可execute	实际运行测试	零报错

Quality Gate Checklist（save至 references/quality-gate.md）：

markdown

## Quality Gate Checklist

- [ ] G0: 目录结构正确（SKILL.md + scripts/ + references/ + assets/）
- [ ] G1: Frontmatter 完整（name, version, description, emoji）
- [ ] G2: description > 50字，含trigger关键词
- [ ] G3: CISO securityreview通过（CVSS < 7.0，STRIDE 无 FAIL）
- [ ] G4: references/ 中文档有链接Description，无悬空引用
- [ ] G5: 所有 scripts/ 脚本已测试，零报错
- [ ] G6: SKILL.md < 500行（渐进式披露正确）
- [ ] G7: 无prohibit文件（README.md/CHANGELOG.md 等）

Phase 6 — 打包与publish（Package & Publish）

使用 package_skill.py 打包：

powershell

# Windows
python.exe <openclaw_path>\skills\skill-creator\scripts\package_skill.py <path/to/skill-folder> <output-dir>

# Linux/macOS
python3 <openclaw_path>/skills/skill-creator/scripts/package_skill.py <path/to/skill-folder> <output-dir>

打包脚本自动execute：

✅ verify YAML frontmatter 格式
✅ 检查 Skill 命名standard
✅ verify目录结构
✅ 检查 description 完整性
✅ confirm文件组织
✅ 打包为 .skill 文件

publish到 ClawHub：

bash

# 登录（如需publish到公共仓库）
clawhub login

# publish
clawhub publish ./<skill-name> \
  --slug <skill-name> \
  --name "<Skill 显示名称>" \
  --version X.Y.Z \
  --changelog "<变更Description>"

publish前最终检查：

markdown

## publish前 Checklist

- [ ] CISO securityreviewreport已生成（Phase 4）
- [ ] Quality Gate 全部通过（Phase 5）
- [ ] .skill 包文件已生成
- [ ] 版本号符合 semver（X.Y.Z）
- [ ] Changelog 已写入（如果已有历史版本）
- [ ] ClawHub slug 已confirm唯1性

快速参考

trigger命令

text

"create Skill" / "新建Skill" / "开发 Skill" / "create1个Skill包"

自然语言指令映射

用户请求	execute动作
"create1个读取 PDF 的 Skill"	初始化 → 需求analyze → 架构design → 实现 → securityreview → 打包
"帮我写1个handle Excel 的Skill"	同上，参考 xlsx skill design模式
"需要1个新 Skill 来做 XX"	需求analyze → confirmtrigger时机和permission

常见错误

跳过securityreview：Phase 4 是强制门禁，不得跳过
手动create目录：必须使用 init_skill.py
SKILL.md 过长：超过 500 行 → 拆分到 references/
description 过短：< 50 字 → trigger时机不明确，Skill 无法激活
引入prohibit文件：README.md/CHANGELOG.md → 删除
硬编码密钥：🚫 reject，必须用环境变量

参考文件

references/design.md — 需求analyze模板和架构design指南
references/security-review.md — 详细 CISO securityreview清单
references/quality-gate.md — quality gate检查表
references/publish-guide.md — ClawHub publish指南

版本历史（Changelog）

版本	日期	Changes	审核人
1.1.0	2026-04-13	新增 Agent 调用接口层（Inter-Agent Interface）：6个 Task 类型（create/design-review/security-review/quality-gate/package/publish）；CISO securityConstraint和security红线；与 ai-skill-maintainer / ai-skill-optimizer 接口关系Definition；CLO compliance登记节点；Day 3 预算概算	CTO-001 / CISO-001
1.0.0	2026-04-11	Initial version：CTO MLOops 6phase创作process + CISO STRIDE securityreviewstandard + G0-G7 quality gate	CTO-001 / CISO-001

rollbackstrategy（Rollback）

如任何phase失败，execute以下操作recover：

bash

# recover到上1个 Git tag
git checkout tags/v<上1版本> -- .

# 或使用快照包（如果有）
clawhub restore ./dist/<skill-name>-v<X.Y.Z>.skill

# verifyrollback成功
git log --oneline -3

rollbacktrigger条件：

Phase 3（G2 securityreview）失败 → rollback到 Phase 2
Phase 4（G3 quality gate）失败 → rollback到 Phase 3
Phase 6（publish）失败 → rollback到 Phase 5

rollback后操作：

recordrollback原因到 references/creation-log.md
notify CTO-001 和 CISO-001
analyze失败原因后重新进入创作process

AI Skill Creator (EN)

Install

AI Skill 创作工作流（CTO × CISO standard）

核心principle

Agent 调用接口（Inter-Agent Interface）

接口身份

TASK 消息格式

可用 Task 类型

Task 参数 Schema

create 参数

security-review 参数

返回值 Schema

错误码

Agent 间调用示例

securityConstraint（接口层）

与其他 Skill 的接口关系

6phase创作process（MLOps Lifecycle for Skill）

Phase 0 — 准备：create目录结构

Phase 1 — 需求analyze（Ideation）

Phase 2 — 架构design

SKILL.md 结构standard

Frontmatter 必需字段

目录结构standard

Phase 3 — 实现（Implementation）

SKILL.md 编写standard

脚本编写standard

资源文件standard

Phase 4 — securityreview（Security Review）

Step 1：代码review（MANDATORY）

Step 2：permissionassess

Step 3：依赖扫描

Step 4：漏洞评分（CVSS）

Step 5：STRIDE 威胁建模

Phase 5 — quality gate（Quality Gate）

Phase 6 — 打包与publish（Package & Publish）

快速参考

trigger命令

自然语言指令映射

常见错误

参考文件

版本历史（Changelog）

rollbackstrategy（Rollback）

Related skills

`create` 参数

`security-review` 参数