RyanJson/run_local_skills.sh at main · Ryan-CW-Code/RyanJson · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
#!/bin/bash
set -euo pipefail

# 本地一键 skills 同步与规范校验。
# 默认行为：
#   1) 同步各技能的 references/terminology.md 到统一占位模板
#   2) 使用仓库内 validator 校验每个技能的 frontmatter 与 agents/openai.yaml
#   3) 校验 skills 文档中的明确路径引用与 AGENTS 路由
#
# 可选参数：
#   --sync-only      仅执行同步
#   --validate-only  仅执行校验

scriptDir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
# shellcheck source=scripts/lib/common.sh
source "${scriptDir}/scripts/lib/common.sh"
repoRoot="$(ryanjson_repo_root_from_source "${BASH_SOURCE[0]}" 0)"
cd "${repoRoot}"

doSync=1
doValidate=1
validator="${repoRoot}/scripts/tools/validate_skills.py"

declare -a skillDirs=()

parse_args() {
	# 解析参数（仅支持同步/校验开关）
	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
			;;
		*)
			ryanjson_log_error "未知参数: $1"
			echo "用法: bash ./run_local_skills.sh [--sync-only|--validate-only]"
			exit 2
			;;
		esac
		shift
	done
}

load_skills() {
	# 收集真正的 skill 目录（要求存在 SKILL.md，排除 shared 与非技能辅助目录）
	mapfile -t skillDirs < <(find skills -mindepth 1 -maxdepth 1 -type d -exec test -f '{}/SKILL.md' ';' -print | sort)
	if [[ ${#skillDirs[@]} -eq 0 ]]; then
		ryanjson_log_info "未发现可处理的技能目录（skills/*，排除 skills/shared）"
		exit 0
	fi
}

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

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

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

INNER_EOF
			cat "${termFile}" >> "${tmpFile}"
			mv "${tmpFile}" "${termFile}"
			ryanjson_log_info "synced ${termFile} (prefixed)"
		fi
	done
}

validate_skills() {
	ryanjson_log_phase "校验技能结构、agents 元数据与 Markdown 路径..."
	for skillDir in "${skillDirs[@]}"; do
		ryanjson_log_info "queued ${skillDir}"
	done

	python3 "${validator}"
}

main() {
	parse_args "$@"

	if [[ ! -f "${validator}" ]]; then
		ryanjson_log_error "未找到仓库内技能校验脚本: ${validator}"
		exit 1
	fi

	load_skills

	ryanjson_print_banner_begin "本地 Skills 任务启动"
	ryanjson_print_banner_kv "sync" "${doSync}"
	ryanjson_print_banner_kv "validate" "${doValidate}"
	ryanjson_print_banner_kv "skills" "${#skillDirs[@]}"
	ryanjson_print_banner_end

	if [[ ${doSync} -eq 1 ]]; then
		sync_terms
	fi

	if [[ ${doValidate} -eq 1 ]]; then
		validate_skills
	fi

	ryanjson_print_banner_begin "本地 Skills 任务完成"
	ryanjson_print_banner_end
}

main "$@"