Skillsmith-JOJO ⚒️#

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

Forging Perfection, One Skill at a Time

---

什么是 Skillsmith-JOJO？#

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

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

---

核心优势#

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

---

快速开始#

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

text

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 — 技能测试框架#

bash

# 基础测试
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 — 安全检查#

bash

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

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

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

检测危险模式：

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

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

bash

# 分析技能
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. 渐进式披露#

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

3. 安全前置#

发布前必须通过：

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

4. 完美主义#

不交半成品：

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

---

目录结构规范#

text

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.mdClawHub 发布指南

---

关于 JOJO's Workshop#

完美主义者的技能工坊

我们相信：

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

---

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