单一事实源：在一个项目里同时管理 AGENTS、CLAUDE、GEMINI 和 Cursor Rules

  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

#!/usr/bin/env bash
set -euo pipefail

ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
AI_DIR="$ROOT_DIR/docs/ai"

APPLY=0
FORCE=0

while [[ $# -gt 0 ]]; do
  case "$1" in
    --apply) APPLY=1; shift ;;
    --force) FORCE=1; shift ;;
    *) echo "Usage: $0 [--apply] [--force]" >&2; exit 2 ;;
  esac
done

require_file() { [[ -f "$1" ]] || { echo "Missing file: $1" >&2; exit 1; }; }
read_file() { cat "$1"; }

is_generated_file() {
  [[ -f "$1" ]] || return 1
  head -n 1 "$1" | rg -q "AI-CONFIG: GENERATED"
}

write_target() {
  local target="$1" content="$2"
  mkdir -p "$(dirname "$target")"

  if [[ -f "$target" && $FORCE -ne 1 ]]; then
    if ! is_generated_file "$target"; then
      echo "SKIP (manual file): ${target#$ROOT_DIR/}"
      return 0
    fi
  fi

  if [[ $APPLY -eq 1 ]]; then
    printf "%s\n" "$content" > "$target"
    echo "WRITE ${target#$ROOT_DIR/}"
  else
    echo "PLAN  ${target#$ROOT_DIR/}"
  fi
}

build_root_doc() {
  local tool="$1"
  cat <<EOF
<!-- AI-CONFIG: GENERATED. DO NOT EDIT DIRECTLY. -->
# $(tr '[:lower:]' '[:upper:]' <<<"$tool") Instructions

$(read_file "$AI_DIR/core.md")

$(read_file "$AI_DIR/tooling/$tool.md")
EOF
}

build_scope_doc() {
  local tool="$1" scope="$2" scope_file="$3"
  cat <<EOF
<!-- AI-CONFIG: GENERATED. DO NOT EDIT DIRECTLY. -->
# Scope Instructions: $scope

本文件仅定义当前目录的增量规则，不重复全局规则。

$(read_file "$scope_file")

$(read_file "$AI_DIR/tooling/$tool.md")
EOF
}

build_cursor_rule() {
  local scope="$1" scope_file="$2"
  cat <<EOF
---
description: Generated scope rule for $scope
globs:
  - $scope/**
alwaysApply: false
---

<!-- AI-CONFIG: GENERATED. DO NOT EDIT DIRECTLY. -->
# Cursor Scope Rule: $scope

$(read_file "$scope_file")
EOF
}

require_file "$AI_DIR/core.md"
require_file "$AI_DIR/scopes.list"
require_file "$AI_DIR/tooling/claude.md"
require_file "$AI_DIR/tooling/codex.md"
require_file "$AI_DIR/tooling/gemini.md"
require_file "$AI_DIR/tooling/cursor.md"

write_target "$ROOT_DIR/AGENTS.md" "$(build_root_doc codex)"
write_target "$ROOT_DIR/CLAUDE.md" "$(build_root_doc claude)"
write_target "$ROOT_DIR/GEMINI.md" "$(build_root_doc gemini)"

while IFS= read -r scope || [[ -n "$scope" ]]; do
  [[ -z "$scope" || "$scope" =~ ^# ]] && continue
  scope_id="${scope//\//-}"
  scope_file="$AI_DIR/scopes/${scope}.md"
  require_file "$scope_file"

  write_target "$ROOT_DIR/$scope/AGENTS.md" "$(build_scope_doc codex "$scope" "$scope_file")"
  write_target "$ROOT_DIR/$scope/CLAUDE.md" "$(build_scope_doc claude "$scope" "$scope_file")"
  write_target "$ROOT_DIR/$scope/GEMINI.md" "$(build_scope_doc gemini "$scope" "$scope_file")"
  write_target "$ROOT_DIR/.cursor/rules/generated-${scope_id}.mdc" "$(build_cursor_rule "$scope" "$scope_file")"
done < "$AI_DIR/scopes.list"

[[ $APPLY -eq 0 ]] && echo -e "\nDry run only. Use --apply to write files."