Skillsmith-JOJO ⚒️

完美主义技能工坊 · JOJO's Workshop 出品

Forging Perfection, One Skill at a Time

什么是 Skillsmith-JOJO？

Skillsmith-JOJO 是一套完整的 AI 技能开发工作流，专为追求完美的开发者设计。

不是简单的代码仓库，而是经过实战验证的技能开发方法论。

核心优势

优势	说明
⚡ 效率提升	5套模板减少50%创建时间
🛡️ 安全前置	发布前安全检查，杜绝危险代码
📊 性能优化	Token分析，确保上下文高效
✅ 质量保证	测试框架，每个技能可验证
📚 最佳实践	多年经验总结，开箱即用

快速开始

创建新技能（7步工作流）

Step 1  选择模板   →  从 templates/ 选择最接近的模板
Step 2  初始化     →  复制模板，修改 name 和 description
Step 3  实现功能   →  编写 scripts/ 和 references/
Step 4  测试验证   →  python skill-test.py <技能路径>
Step 5  安全检查   →  python security-check.py <技能路径>
Step 6  性能分析   →  python token-analyzer.py <技能路径>
Step 7  打包发布   →  clawhub publish <技能路径>

模板库（5套实战模板）

模板	适用场景	复杂度
📡 API 集成	调用外部 API、数据获取、OAuth	中
📁 文件处理	格式转换、批量处理、PDF/Excel	高
🤖 自动化工作流	多步骤自动化、定时任务、监控	中
📊 数据查询	SQL 查询、API 数据分析、可视化	低
📦 Git 助手	智能提交、分支管理、代码审查	中

每个模板包含：

✅ 完整 SKILL.md 结构
✅ 核心脚本代码
✅ 参考文档
✅ 使用示例

工具集（3个核心工具）

1️⃣ skill-test.py — 技能测试框架

# 基础测试
python skill-test.py <技能路径>

# 快速测试（跳过脚本执行）
python skill-test.py <技能路径> --quick

# 输出JSON报告
python skill-test.py <技能路径> --output report.json

检查项目：

SKILL.md 格式和必填字段
YAML frontmatter 完整性
脚本语法正确性
目录结构规范性

2️⃣ security-check.py — 安全检查

# 标准检查
python security-check.py <技能路径>

# 严格模式（中风险也失败）
python security-check.py <技能路径> --strict

# 输出JSON报告
python security-check.py <技能路径> --output security.json

检测危险模式：

风险级别	模式	处理
🚨 EXTREME	curl到未知URL、eval/exec、sudo	立即拒绝
🔴 HIGH	访问.ssh/.aws、读取个人记忆文件	人工审查
🟡 MEDIUM	安装未知包、IP直连	谨慎安装
🟢 LOW	删除文件、修改系统	基础审查

3️⃣ token-analyzer.py — Token 性能分析

# 分析技能
python token-analyzer.py <技能路径>

# 输出JSON报告
python token-analyzer.py <技能路径> --output perf.json

评级标准：

评级	Token数	说明
A 优秀	≤ 1500	精简高效
B 良好	≤ 3000	可接受
C 需优化	≤ 5000	建议拆分
D 严重臃肿	> 5000	必须优化

设计原则

1. 精简至上

SKILL.md 只写 AI 不知道的内容：

❌ 不写 Python 基础语法
❌ 不写 Git 基础命令
✅ 只写领域特定知识

2. 渐进式披露

层级	内容	加载时机
Frontmatter	name + description	始终在上下文
SKILL.md Body	核心工作流	触发时加载
references/	详细文档	按需加载
scripts/	可执行代码	执行时加载

3. 安全前置

发布前必须通过：

skill-test.py — 结构完整性
security-check.py — 安全审查
token-analyzer.py — 性能达标

4. 完美主义

不交半成品：

每个技能都要有完整文档
每个脚本都要有错误处理
每个功能都要经过测试

目录结构规范

skill-name/
├── SKILL.md              # 必需：技能定义
├── scripts/              # 可选：可执行脚本
│   ├── main.py          # 主脚本
│   └── utils.py         # 工具函数
├── references/          # 可选：参考文档
│   ├── api.md          # API 文档
│   └── examples.md     # 示例
└── assets/              # 可选：模板文件
    └── template.xlsx    # Excel 模板

常见问题

Q: 如何选择模板？

A: 根据你的技能类型选择最接近的模板，然后在此基础上修改。

Q: 必须使用所有工具吗？

A: 建议全部通过。如有特殊情况，至少通过安全检查。

Q: Token 数超标怎么办？

A: 将详细内容移至 references/ 目录，SKILL.md 只保留核心流程。

Q: 如何发布技能？

A: 查看 references/publishing.md 获取详细指南。

引用文件

文件	说明
best-practices.md	技能设计最佳实践
publishing.md	ClawHub 发布指南

关于 JOJO's Workshop

完美主义者的技能工坊

我们相信：

好技能是打磨出来的，不是堆出来的
每个细节都值得认真对待
工具应该为人服务，而不是相反

Skillsmith-JOJO · JOJO's Workshop · 完美主义者的技能工坊 Forging Perfection, One Skill at a Time

skillsmith-jojo

Safety Notice

Copy this and send it to your AI assistant to learn