Files
claude-config/skills/ssw-loop/scripts/check_encode_unique.sh
T
sswandClaude ec1c4100dc ssw-loop: check_encode_unique.sh 加 --ignore-existing 标志 (P3-8)
阶段 6 复跑可正确 PASS, 不再对已建 enCode 误报冲突

Co-Authored-By: Claude <[email protected]>
2026-07-28 10:46:22 +08:00

257 lines
8.0 KiB
Bash
Executable File

#!/bin/bash
# check_encode_unique.sh — 阶段 2.5 enCode 校验 (硬关卡, 重复 = FAIL)
#
# 来源: tdd2 实战 2026-07-25 BS-47 (字典冲突) + BS-新131 (form 改名) + BS-新133
# 规则: docs/{app}/design.md §9 enCode 清单必须全平台唯一
#
# 用法: bash check_encode_unique.sh <app_dir>
# 例: bash check_encode_unique.sh docs/tdd2/
#
# 退出码:
# 0 = PASS (无冲突)
# 1 = FAIL (有冲突, 见 stdout 输出)
# 2 = WARN (fullName 冲突, 建议加 appCode 前缀)
set -e
APP_DIR="${1:?用法: $0 <app_dir>}"
APP_CODE=$(basename "$APP_DIR")
DESIGN_MD="$APP_DIR/design.md"
# v0.22+ (2026-07-28 tdd5 实战): --ignore-existing 跳过已存在的 enCode (阶段 6 复跑误判)
# 阶段 2.5 (设计时) 跑不带 --ignore-existing: 严格模式, 任何冲突都报 FAIL
# 阶段 6 (总结时) 跑带 --ignore-existing: 宽松模式, 已创建的 enCode 不算冲突, 只比对"越界新增"
IGNORE_EXISTING=""
for arg in "$@"; do
case "$arg" in
--ignore-existing) IGNORE_EXISTING=1 ;;
esac
done
echo "🔍 阶段 2.5 enCode 校验: $APP_CODE"
echo " design: $DESIGN_MD"
if [ -n "$IGNORE_EXISTING" ]; then
echo " 模式: --ignore-existing (跳过已建 enCode, 阶段 6 复跑专用)"
fi
echo ""
if [ ! -f "$DESIGN_MD" ]; then
echo "❌ FAIL: design.md 不存在: $DESIGN_MD"
exit 1
fi
# 1. 解析 design.md §9 enCode 清单
# 匹配: | {enCode} | {fullName} | 后面带 "UNIQUE" 或 "❌" 等
echo "📋 1. 解析 design.md §9 enCode 清单..."
# 用 python 解析 markdown 表格 (跨平台稳定)
DICT_ENCODES=$(python3 -c "
import re, sys
with open('$DESIGN_MD', 'r', encoding='utf-8') as f:
content = f.read()
m = re.search(r'### 9\.1.*?(?=### 9\.[234]|\Z)', content, re.DOTALL)
if not m:
sys.exit(0)
table = m.group(0)
encodes = []
for line in table.split('\n'):
if not line.strip().startswith('|'):
continue
cells = [c.strip() for c in line.split('|')[1:-1]]
if len(cells) >= 2 and cells[0] not in ('字典 enCode', '', '---') and not all(set(c) <= set('-—') for c in cells):
encodes.append(cells[0])
print('\n'.join(encodes))
")
FORM_ENCODES=$(python3 -c "
import re, sys
with open('$DESIGN_MD', 'r', encoding='utf-8') as f:
content = f.read()
m = re.search(r'### 9\.2.*?(?=### 9\.[34]|\Z)', content, re.DOTALL)
if not m:
sys.exit(0)
table = m.group(0)
encodes = []
for line in table.split('\n'):
if not line.strip().startswith('|'):
continue
cells = [c.strip() for c in line.split('|')[1:-1]]
if len(cells) >= 2 and cells[0] not in ('form enCode', '', '---') and not all(set(c) <= set('-—') for c in cells):
encodes.append(cells[0])
print('\n'.join(encodes))
")
WF_ENCODES=$(python3 -c "
import re, sys
with open('$DESIGN_MD', 'r', encoding='utf-8') as f:
content = f.read()
m = re.search(r'### 9\.3.*?(?=### 9\.4|\Z)', content, re.DOTALL)
if not m:
sys.exit(0)
table = m.group(0)
encodes = []
for line in table.split('\n'):
if not line.strip().startswith('|'):
continue
cells = [c.strip() for c in line.split('|')[1:-1]]
if len(cells) >= 2 and cells[0] not in ('workflow enCode', '', '---') and not all(set(c) <= set('-—') for c in cells):
encodes.append(cells[0])
print('\n'.join(encodes))
")
MENU_ENCODES=$(python3 -c "
import re, sys
with open('$DESIGN_MD', 'r', encoding='utf-8') as f:
content = f.read()
m = re.search(r'### 9\.4.*?(?=## |\Z)', content, re.DOTALL)
if not m:
sys.exit(0)
table = m.group(0)
encodes = []
for line in table.split('\n'):
if not line.strip().startswith('|'):
continue
cells = [c.strip() for c in line.split('|')[1:-1]]
if len(cells) >= 2 and cells[0] not in ('menu enCode', '', '---') and not all(set(c) <= set('-—') for c in cells):
encodes.append(cells[0])
print('\n'.join(encodes))
")
if [ -z "$DICT_ENCODES$FORM_ENCODES$WF_ENCODES$MENU_ENCODES" ]; then
echo "❌ FAIL: design.md §9 没找到 enCode 清单"
echo " 请按 references/encode-validation.md §3 模板填写"
exit 1
fi
echo " ✓ dict enCode: $(echo "$DICT_ENCODES" | wc -l) 个"
echo " ✓ form enCode: $(echo "$FORM_ENCODES" | wc -l) 个"
echo " ✓ workflow enCode: $(echo "$WF_ENCODES" | wc -l) 个"
echo " ✓ menu enCode: $(echo "$MENU_ENCODES" | wc -l) 个"
# 2. 拉平台当前 enCode
echo ""
echo "📡 2. 拉 dacli 当前 enCode 库..."
DCCLI="npx tsx $ccWorkDir/dacli/src/cli.ts"
# 字典 enCode + fullName
DICT_PLATFORM_JSON=$($DCCLI dict typeList --json 2>/dev/null | python3 -c "
import json, sys
d = json.load(sys.stdin)
items = []
def walk(lst):
for x in lst:
ec = x.get('enCode')
fn = x.get('fullName')
id_ = x.get('id')
if ec:
items.append({'enCode': ec, 'fullName': fn or '', 'id': id_})
if x.get('children'):
walk(x['children'])
walk(d.get('list', []))
print(json.dumps(items))
" 2>/dev/null || echo "[]")
# form enCode
FORM_PLATFORM_JSON=$($DCCLI form list --json 2>/dev/null | python3 -c "
import json, sys
d = json.load(sys.stdin)
items = []
for x in d.get('list', []):
items.append({'enCode': x.get('enCode'), 'fullName': x.get('fullName') or '', 'id': x.get('id')})
print(json.dumps(items))
" 2>/dev/null || echo "[]")
# workflow enCode
WF_PLATFORM_JSON=$($DCCLI workflow selector --json 2>/dev/null | python3 -c "
import json, sys
try:
d = json.load(sys.stdin)
items = []
for x in d:
if isinstance(x, dict):
items.append({'enCode': x.get('enCode'), 'fullName': x.get('fullName') or '', 'id': x.get('id')})
print(json.dumps(items))
except:
print('[]')
" 2>/dev/null || echo "[]")
echo " ✓ 平台字典: $(echo "$DICT_PLATFORM_JSON" | python3 -c "import json,sys; print(len(json.load(sys.stdin)))") 个"
echo " ✓ 平台表单: $(echo "$FORM_PLATFORM_JSON" | python3 -c "import json,sys; print(len(json.load(sys.stdin)))") 个"
echo " ✓ 平台工作流: $(echo "$WF_PLATFORM_JSON" | python3 -c "import json,sys; print(len(json.load(sys.stdin)))") 个"
# 3. 校验
echo ""
echo "🔍 3. enCode 冲突检查..."
PASS_COUNT=0
FAIL_COUNT=0
WARN_COUNT=0
check_encodes() {
local TYPE="$1"
local DESIGN_LIST="$2"
local PLATFORM_JSON="$3"
if [ -z "$DESIGN_LIST" ]; then
return
fi
while IFS= read -r ENCODE; do
[ -z "$ENCODE" ] && continue
# 检查 enCode 是否已存在
set +e
CONFLICT=$(echo "$PLATFORM_JSON" | python3 -c "
import json, sys
data = json.load(sys.stdin)
target = '$ENCODE'
for x in data:
if x.get('enCode') == target:
print(f\"enCode='{target}' 冲突: 已存在 (fullName='{x.get('fullName','')}', id='{x.get('id','')}')\")
sys.exit(0)
sys.exit(1)
" 2>&1)
RET=$?
set -e
if [ $RET -eq 0 ] && [ -n "$CONFLICT" ]; then
if [ -n "$IGNORE_EXISTING" ]; then
echo " ⚠️ $TYPE EXISTING: $ENCODE (已建, --ignore-existing 跳过)"
PASS_COUNT=$((PASS_COUNT+1))
else
echo " ❌ $TYPE FAIL: $CONFLICT"
FAIL_COUNT=$((FAIL_COUNT+1))
fi
else
echo " ✅ $TYPE UNIQUE: $ENCODE"
PASS_COUNT=$((PASS_COUNT+1))
fi
done <<< "$DESIGN_LIST"
}
check_encodes "dict" "$DICT_ENCODES" "$DICT_PLATFORM_JSON"
check_encodes "form" "$FORM_ENCODES" "$FORM_PLATFORM_JSON"
check_encodes "wf" "$WF_ENCODES" "$WF_PLATFORM_JSON"
# 4. 总结
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "📊 校验总结:"
echo " ✅ PASS: $PASS_COUNT 个 enCode 唯一"
echo " ❌ FAIL: $FAIL_COUNT 个 enCode 冲突"
echo " ⚠️ WARN: $WARN_COUNT 个 fullName 建议改"
if [ $FAIL_COUNT -gt 0 ]; then
echo ""
echo "❌ FAIL: $FAIL_COUNT 个 enCode 冲突, 必须在阶段 2 修复"
echo ""
echo "修复步骤:"
echo " 1. 改 design.md §9 的 enCode (加 appCode 前缀或换语义)"
echo " 2. 重跑: bash $0 $APP_DIR"
echo " 3. 通过后才进阶段 3 (审核) → 阶段 4 (执行)"
exit 1
fi
echo ""
echo "✅ PASS: 所有 enCode 唯一, 可进阶段 3 (审核)"
exit 0