Spec 上下文定位（FEATURE_DIR）

概览

在任何 Spec 命令/技能里，只要会读写 requirements/*.md，就必须先确定 {FEATURE_DIR}。本仓库以 当前 Git 分支名作为 spec pack 的定位锚点，禁止猜路径。

开始时宣布：「我正在使用 spec-context 技能定位当前 Spec Pack（FEATURE_DIR）。」

何时使用

• 你将要读/写：{FEATURE_DIR}/requirements/raw.md | solution.md | prd.md | prototype.md
• 你不确定当前处于哪个 spec pack（担心读写错目录）
• 你看到“分支名不规范 / 目录结构不完整 / 缺 .aisdlc”之类上下文错误

唯一做法（PowerShell / Bash）

在 Windows/PowerShell 环境用 PowerShell 版；在 macOS/Linux 或 Git Bash 环境用 Bash 版（两者校验规则对齐）。

PowerShell

. ".\spec-common.ps1"
$context = Get-SpecContext
$FEATURE_DIR = $context.FEATURE_DIR
Write-Host "FEATURE_DIR=$FEATURE_DIR"

Bash

source "./spec-common.sh"
get_spec_context
echo "FEATURE_DIR=$FEATURE_DIR"

硬规则（必须遵守）

• 脚本位置：脚本与本 SKILL.md 同目录
• 先定位再读写：任何读/写 requirements/*.md 之前，必须先运行上面的脚本并回显 FEATURE_DIR=...。
• 失败就停止：PowerShell 的 Get-SpecContext 或 Bash 片段任意一步报错时，必须立刻停止，不得继续生成/写文件内容（否则几乎必然跑偏上下文）。
• 只用 FEATURE_DIR 拼路径：后续所有路径都必须以 $FEATURE_DIR（PowerShell）或 ${FEATURE_DIR}（Bash）为前缀（禁止用当前工作目录做相对路径猜测）。

常见错误

• 在非 spec 分支上执行：分支名不符合 {num}-{short-name}，会导致无法定位 spec pack。
• 手写 .aisdlc/specs/... 路径：人会写错，AI 更容易写错；必须以脚本输出为准。
• 继续执行“生成文档”：只要上下文失败，就停止并先修复分支/目录结构。