1155c7564e
- Add language switch link to root README - Translate README.md to docs/zh-CN/README.md - Translate USER-GUIDE.md to docs/zh-CN/USER-GUIDE.md - Translate all 13 reference documents to docs/zh-CN/references/ Key terminology mappings: - context engineering → 上下文工程 - spec-driven development → 规格驱动开发 - context rot → 上下文衰减 - phase → 阶段 - milestone → 里程碑 - roadmap → 路线图 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.5 KiB
1.5 KiB
阶段参数解析
为操作阶段的命令解析和规范化阶段参数。
提取
从 $ARGUMENTS 中：
- 提取阶段编号（第一个数字参数）
- 提取标志（以
--为前缀） - 剩余文本为描述（用于 insert/add 命令）
使用 gsd-tools
find-phase 命令一步完成规范化和验证：
PHASE_INFO=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" find-phase "${PHASE}")
返回 JSON 包含：
found: true/falsedirectory: 阶段目录的完整路径phase_number: 规范化的编号（如 "06"、"06.1"）phase_name: 名称部分（如 "foundation"）plans: PLAN.md 文件数组summaries: SUMMARY.md 文件数组
手动规范化（遗留）
将整数阶段补零到 2 位。保留小数后缀。
# 规范化阶段编号
if [[ "$PHASE" =~ ^[0-9]+$ ]]; then
# 整数: 8 → 08
PHASE=$(printf "%02d" "$PHASE")
elif [[ "$PHASE" =~ ^([0-9]+)\.([0-9]+)$ ]]; then
# 小数: 2.1 → 02.1
PHASE=$(printf "%02d.%s" "${BASH_REMATCH[1]}" "${BASH_REMATCH[2]}")
fi
验证
使用 roadmap get-phase 验证阶段存在：
PHASE_CHECK=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" roadmap get-phase "${PHASE}")
if [ "$(printf '%s\n' "$PHASE_CHECK" | jq -r '.found')" = "false" ]; then
echo "ERROR: Phase ${PHASE} not found in roadmap"
exit 1
fi
目录查找
使用 find-phase 进行目录查找：
PHASE_DIR=$(node "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" find-phase "${PHASE}" --raw)