skill-authoring

name	skill-authoring
description	Skill 编写规范与最佳实践。触发词：/skill-authoring、编写 skill、创建技能

Skill 编写规范

核心原则

原则	说明
脚本优先	功能实现用脚本（sh/python），非内联代码
可执行性	Skill 必须可直接执行
可测试性	每个脚本可独立运行验证
可维护性	脚本与文档分离

实现优先级

优先级	方式	场景
1	Bash (.sh)	系统操作、API 调用、流程自动化
2	Python (.py)	复杂逻辑、数据处理、第三方库
3	内联代码	仅当逻辑极简且不可复用

目录结构

skill-name/
├── skill.md          # 触发词、工作流程、使用说明
├── scripts/          # 脚本目录
│   ├── main.sh       # 主脚本
│   └── helper.py     # 辅助脚本
└── templates/        # 模板文件（可选）

Bash 脚本模板

#!/bin/bash
# ============================================================
# skill-name: 功能描述
# ============================================================

set -e  # 遇错即停

# ==================== 配置 ====================
CONFIG_VAR="value"

# ==================== 工具函数 ====================
check_dependencies() {
    command -v jq >/dev/null || {  ;  1; }
}


() {
    check_dependencies
    
}

main