RyanJson/run_local_skills.sh

#!/bin/bash
set -euo pipefail

# 本地一键 skills 同步与规范校验。
# 默认行为：
#   1) 同步各技能的 references/terminology.md 到统一占位模板
#   2) 使用 skill-creator 的 quick_validate.py 校验每个技能
#   3) 校验 agents/openai.yaml 关键字段与默认 prompt 的技能名引用
#
# 可选参数：
#   --sync-only      仅执行同步
#   --validate-only  仅执行校验

scriptDir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
cd "${scriptDir}"

doSync=1
doValidate=1

while (($# > 0)); do
	case "$1" in
	--sync-only)
		doValidate=0
		;;
	--validate-only)
		doSync=0
		;;
	-h | --help)
		echo "用法: bash ./run_local_skills.sh [--sync-only|--validate-only]"
		exit 0
		;;
	*)
		echo "[错误] 未知参数: $1"
		echo "用法: bash ./run_local_skills.sh [--sync-only|--validate-only]"
		exit 2
		;;
	esac
	shift
done

validator="/root/.codex/skills/.system/skill-creator/scripts/quick_validate.py"
if [[ ! -f "${validator}" ]]; then
	echo "[错误] 未找到技能校验脚本: ${validator}"
	exit 1
fi

mapfile -t skillDirs < <(find skills -mindepth 1 -maxdepth 1 -type d ! -name shared | sort)
if [[ ${#skillDirs[@]} -eq 0 ]]; then
	echo "[信息] 未发现可处理的技能目录（skills/*，排除 skills/shared）"
	exit 0
fi

echo "===================================================="
echo "本地 Skills 任务启动"
echo "  - sync=${doSync}"
echo "  - validate=${doValidate}"
echo "  - skills=${#skillDirs[@]}"
echo "===================================================="

if [[ ${doSync} -eq 1 ]]; then
	echo "[阶段] 同步术语占位文档..."
	for skillDir in "${skillDirs[@]}"; do
		termFile="${skillDir}/references/terminology.md"
		mkdir -p "$(dirname "${termFile}")"
		if [[ ! -f "${termFile}" ]]; then
			cat > "${termFile}" <<'EOF'
# 术语字典

- 统一术语定义复用共享文档：`../../shared/terminology.md`。
- 如出现本技能专属术语，可在本文件追加扩展，不覆盖共享定义。
EOF
			echo "  - synced ${termFile} (created)"
		elif grep -Fq '../../shared/terminology.md' "${termFile}"; then
			echo "  - synced ${termFile} (already linked)"
		else
			tmpFile="$(mktemp)"
			cat > "${tmpFile}" <<'EOF'
# 术语字典

- 统一术语定义复用共享文档：`../../shared/terminology.md`。
- 如出现本技能专属术语，可在本文件追加扩展，不覆盖共享定义。

EOF
			cat "${termFile}" >> "${tmpFile}"
			mv "${tmpFile}" "${termFile}"
			echo "  - synced ${termFile} (prefixed)"
		fi
	done
fi

if [[ ${doValidate} -eq 1 ]]; then
	echo "[阶段] 校验技能结构与 agents 元数据..."
	for skillDir in "${skillDirs[@]}"; do
		skillFile="${skillDir}/SKILL.md"
		openaiFile="${skillDir}/agents/openai.yaml"

		python3 "${validator}" "${skillDir}" >/dev/null

		if [[ ! -f "${openaiFile}" ]]; then
			echo "[错误] 缺少 agents/openai.yaml: ${openaiFile}"
			exit 1
		fi

		if ! rg -q '^[[:space:]]*display_name:' "${openaiFile}"; then
			echo "[错误] 缺少 interface.display_name: ${openaiFile}"
			exit 1
		fi
		if ! rg -q '^[[:space:]]*short_description:' "${openaiFile}"; then
			echo "[错误] 缺少 interface.short_description: ${openaiFile}"
			exit 1
		fi
		if ! rg -q '^[[:space:]]*default_prompt:' "${openaiFile}"; then
			echo "[错误] 缺少 interface.default_prompt: ${openaiFile}"
			exit 1
		fi

		skillName="$(awk '
			BEGIN { inFm=0 }
			/^---[[:space:]]*$/ { if (inFm==0) { inFm=1; next } else { exit } }
			inFm==1 && /^name:[[:space:]]*/ {
				sub(/^name:[[:space:]]*/, "", $0)
				print $0
				exit
			}
		' "${skillFile}")"

		if [[ -z "${skillName}" ]]; then
			echo "[错误] 未能从 ${skillFile} 读取 name"
			exit 1
		fi

		if ! grep -Fq "\$${skillName}" "${openaiFile}"; then
			echo "[错误] default_prompt 未引用 \$${skillName}: ${openaiFile}"
			exit 1
		fi

		echo "  - valid ${skillDir}"
	done
fi

echo "===================================================="
echo "本地 Skills 任务完成"
echo "===================================================="