286 lines
6.9 KiB
Bash
286 lines
6.9 KiB
Bash
#!/usr/bin/env sh
|
||
set -eu
|
||
|
||
# Vendor a trimmed Playbook snapshot into a target project (offline copy),
|
||
# then run sync_standards to materialize .agents/<lang>/ and .gitattributes in
|
||
# the target project root.
|
||
#
|
||
# Usage:
|
||
# sh scripts/vendor_playbook.sh <project-root> # default: tsl
|
||
# sh scripts/vendor_playbook.sh <project-root> tsl cpp
|
||
# sh scripts/vendor_playbook.sh <project-root> --langs tsl,cpp
|
||
#
|
||
# Notes:
|
||
# - Snapshot is written to: <project-root>/docs/standards/playbook/
|
||
# - Existing snapshot is backed up before overwrite.
|
||
# - Ruleset templates from rulesets/ will be copied to snapshot for sync_standards use.
|
||
|
||
SCRIPT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd -P)"
|
||
SRC="$(CDPATH= cd -- "$SCRIPT_DIR/.." && pwd -P)"
|
||
|
||
usage() {
|
||
cat <<'EOF' >&2
|
||
Usage:
|
||
sh scripts/vendor_playbook.sh <project-root> # default: tsl
|
||
sh scripts/vendor_playbook.sh <project-root> tsl cpp
|
||
sh scripts/vendor_playbook.sh <project-root> --langs tsl,cpp
|
||
EOF
|
||
}
|
||
|
||
if [ "$#" -lt 1 ]; then
|
||
usage
|
||
exit 1
|
||
fi
|
||
|
||
if [ "${1:-}" = "-h" ] || [ "${1:-}" = "--help" ]; then
|
||
usage
|
||
exit 0
|
||
fi
|
||
|
||
PROJECT_ROOT="$1"
|
||
shift
|
||
|
||
langs=""
|
||
if [ "${1:-}" = "--langs" ]; then
|
||
langs="${2:-}"
|
||
shift 2 || true
|
||
fi
|
||
if [ -z "${langs:-}" ] && [ "$#" -gt 0 ]; then
|
||
langs="$*"
|
||
fi
|
||
|
||
if [ -z "${langs:-}" ]; then
|
||
langs="tsl"
|
||
fi
|
||
|
||
timestamp="$(date +%Y%m%d%H%M%S 2>/dev/null || echo bak)"
|
||
|
||
if [ ! -d "$PROJECT_ROOT" ]; then
|
||
echo "ERROR: project root does not exist: $PROJECT_ROOT" >&2
|
||
exit 1
|
||
fi
|
||
PROJECT_ROOT_ABS="$(CDPATH= cd -- "$PROJECT_ROOT" && pwd -P)"
|
||
DEST_PREFIX="$PROJECT_ROOT_ABS/docs/standards/playbook"
|
||
DEST_STANDARDS="$PROJECT_ROOT_ABS/docs/standards"
|
||
|
||
mkdir -p "$DEST_STANDARDS"
|
||
|
||
if [ -e "$DEST_PREFIX" ]; then
|
||
mv "$DEST_PREFIX" "$DEST_STANDARDS/playbook.bak.$timestamp"
|
||
echo "Backed up existing snapshot -> docs/standards/playbook.bak.$timestamp"
|
||
fi
|
||
|
||
mkdir -p "$DEST_PREFIX"
|
||
|
||
# Always include: scripts + gitattributes + docs/common + codex/skills
|
||
cp "$SRC/.gitattributes" "$DEST_PREFIX/.gitattributes"
|
||
cp -R "$SRC/scripts" "$DEST_PREFIX/"
|
||
cp -R "$SRC/codex" "$DEST_PREFIX/"
|
||
cp "$SRC/SKILLS.md" "$DEST_PREFIX/SKILLS.md"
|
||
|
||
mkdir -p "$DEST_PREFIX/docs"
|
||
cp -R "$SRC/docs/common" "$DEST_PREFIX/docs/"
|
||
|
||
# Copy rulesets
|
||
mkdir -p "$DEST_PREFIX/rulesets"
|
||
cp "$SRC/rulesets/index.md" "$DEST_PREFIX/rulesets/index.md"
|
||
# Compatibility: keep a mirrored .agents/ snapshot when present.
|
||
if [ -d "$SRC/.agents" ]; then
|
||
cp -R "$SRC/.agents" "$DEST_PREFIX/"
|
||
fi
|
||
|
||
mkdir -p "$DEST_PREFIX/templates"
|
||
if [ -d "$SRC/templates/ci" ]; then
|
||
cp -R "$SRC/templates/ci" "$DEST_PREFIX/templates/"
|
||
fi
|
||
|
||
old_ifs="${IFS}"
|
||
IFS=', '
|
||
set -- $langs
|
||
IFS="${old_ifs}"
|
||
|
||
langs_csv=""
|
||
for lang in "$@"; do
|
||
[ -n "$lang" ] || continue
|
||
|
||
case "$lang" in
|
||
""|*/*|*\\*|*..*)
|
||
echo "ERROR: invalid lang=$lang" >&2
|
||
exit 1
|
||
;;
|
||
esac
|
||
|
||
if [ ! -d "$SRC/docs/$lang" ]; then
|
||
echo "ERROR: docs not found for lang=$lang ($SRC/docs/$lang)" >&2
|
||
exit 1
|
||
fi
|
||
|
||
if [ ! -d "$SRC/rulesets/$lang" ]; then
|
||
echo "ERROR: rulesets not found for lang=$lang ($SRC/rulesets/$lang)" >&2
|
||
exit 1
|
||
fi
|
||
|
||
cp -R "$SRC/docs/$lang" "$DEST_PREFIX/docs/"
|
||
cp -R "$SRC/rulesets/$lang" "$DEST_PREFIX/rulesets/"
|
||
if [ -d "$SRC/templates/$lang" ]; then
|
||
cp -R "$SRC/templates/$lang" "$DEST_PREFIX/templates/"
|
||
fi
|
||
|
||
if [ -n "$langs_csv" ]; then
|
||
langs_csv="$langs_csv,$lang"
|
||
else
|
||
langs_csv="$lang"
|
||
fi
|
||
done
|
||
|
||
cat >"$DEST_PREFIX/docs/index.md" <<EOF
|
||
# 文档导航（Docs Index）
|
||
|
||
本快照为裁剪版 Playbook（langs: ${langs_csv}）。
|
||
|
||
## 跨语言（common）
|
||
|
||
- 提交信息与版本号：\`common/commit_message.md\`
|
||
EOF
|
||
|
||
append_docs_section() {
|
||
lang="$1"
|
||
case "$lang" in
|
||
tsl)
|
||
cat >>"$DEST_PREFIX/docs/index.md" <<'EOF'
|
||
|
||
## TSL（tsl）
|
||
|
||
- 代码风格：`tsl/code_style.md`
|
||
- 命名规范：`tsl/naming.md`
|
||
- 语法手册：`tsl/syntax_book/index.md`
|
||
- 工具链与验证命令（模板）：`tsl/toolchain.md`
|
||
EOF
|
||
;;
|
||
cpp)
|
||
cat >>"$DEST_PREFIX/docs/index.md" <<'EOF'
|
||
|
||
## C++（cpp）
|
||
|
||
- 代码风格：`cpp/code_style.md`
|
||
- 命名规范：`cpp/naming.md`
|
||
- 工具链与验证命令（模板）：`cpp/toolchain.md`
|
||
- 第三方依赖（Conan）：`cpp/dependencies_conan.md`
|
||
- clangd 配置：`cpp/clangd.md`
|
||
EOF
|
||
;;
|
||
python)
|
||
cat >>"$DEST_PREFIX/docs/index.md" <<'EOF'
|
||
|
||
## Python（python）
|
||
|
||
- 代码风格：`python/style_guide.md`
|
||
- 工具链：`python/tooling.md`
|
||
- 配置清单：`python/configuration.md`
|
||
EOF
|
||
;;
|
||
markdown)
|
||
cat >>"$DEST_PREFIX/docs/index.md" <<'EOF'
|
||
|
||
## Markdown（markdown）
|
||
|
||
- 代码块与行内代码格式：`markdown/index.md`
|
||
EOF
|
||
;;
|
||
esac
|
||
}
|
||
|
||
for lang in "$@"; do
|
||
[ -n "$lang" ] || continue
|
||
append_docs_section "$lang"
|
||
done
|
||
|
||
commit=""
|
||
if command -v git >/dev/null 2>&1; then
|
||
commit="$(git -C "$SRC" rev-parse HEAD 2>/dev/null || true)"
|
||
fi
|
||
|
||
cat >"$DEST_PREFIX/README.md" <<EOF
|
||
# Playbook（裁剪快照）
|
||
|
||
本目录为从 Playbook vendoring 的裁剪快照（langs: ${langs_csv}）。
|
||
|
||
## 使用
|
||
|
||
在目标项目根目录执行（多语言一次同步）：
|
||
|
||
\`\`\`sh
|
||
sh docs/standards/playbook/scripts/sync_standards.sh ${langs_csv}
|
||
\`\`\`
|
||
|
||
查看规范入口：
|
||
|
||
- \`docs/standards/playbook/docs/index.md\`
|
||
- \`.agents/index.md\`
|
||
|
||
## Codex skills（可选）
|
||
|
||
安装到本机（需要先在 \`~/.codex/config.toml\` 启用 skills；见 \`docs/standards/playbook/SKILLS.md\`）：
|
||
|
||
\`\`\`sh
|
||
sh docs/standards/playbook/scripts/install_codex_skills.sh
|
||
\`\`\`
|
||
|
||
## CI templates（可选）
|
||
|
||
目标项目可复制启用的 CI 示例模板（如 Gitea Actions）：\`templates/ci/\`。
|
||
EOF
|
||
|
||
cat >"$DEST_PREFIX/SOURCE.md" <<EOF
|
||
# SOURCE
|
||
|
||
- Source: $SRC
|
||
- Commit: ${commit:-N/A}
|
||
- Date: $(date -u +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date)
|
||
- Langs: ${langs_csv}
|
||
- Generated-by: scripts/vendor_playbook.sh
|
||
EOF
|
||
|
||
echo "Vendored snapshot -> $DEST_PREFIX"
|
||
|
||
PROJECT_AGENTS_ROOT="$PROJECT_ROOT_ABS/.agents"
|
||
PROJECT_AGENTS_INDEX="$PROJECT_AGENTS_ROOT/index.md"
|
||
mkdir -p "$PROJECT_AGENTS_ROOT"
|
||
if [ ! -f "$PROJECT_AGENTS_INDEX" ]; then
|
||
cat >"$PROJECT_AGENTS_INDEX" <<EOF
|
||
# .agents（多语言）
|
||
|
||
本目录用于存放仓库级/语言级的代理规则集。
|
||
|
||
本项目已启用的规则集：
|
||
EOF
|
||
|
||
for lang in "$@"; do
|
||
case "$lang" in
|
||
tsl) printf '%s\n' "- .agents/tsl/：TSL 相关规则集（适用于 .tsl/.tsf）" >>"$PROJECT_AGENTS_INDEX" ;;
|
||
cpp) printf '%s\n' "- .agents/cpp/：C++ 相关规则集（C++23，含 Modules）" >>"$PROJECT_AGENTS_INDEX" ;;
|
||
python) printf '%s\n' "- .agents/python/：Python 相关规则集" >>"$PROJECT_AGENTS_INDEX" ;;
|
||
markdown) printf '%s\n' "- .agents/markdown/：Markdown 相关规则集（仅代码格式化）" >>"$PROJECT_AGENTS_INDEX" ;;
|
||
esac
|
||
done
|
||
|
||
cat >>"$PROJECT_AGENTS_INDEX" <<'EOF'
|
||
|
||
入口建议从：
|
||
EOF
|
||
|
||
for lang in "$@"; do
|
||
printf '%s\n' "- .agents/$lang/index.md" >>"$PROJECT_AGENTS_INDEX"
|
||
done
|
||
|
||
cat >>"$PROJECT_AGENTS_INDEX" <<'EOF'
|
||
|
||
标准快照文档入口：
|
||
|
||
- docs/standards/playbook/docs/index.md
|
||
EOF
|
||
fi
|
||
|
||
SYNC_ROOT="$PROJECT_ROOT_ABS" sh "$DEST_PREFIX/scripts/sync_standards.sh" "$@"
|
||
echo "Done."
|