Spec 上下文定位（FEATURE_DIR）

概览

读写 requirements/*.md 前必须先确定 {FEATURE_DIR}。以当前 Git 分支名为锚点，禁止猜路径。

如果仓库包含 .gitmodules，spec-context 还应额外暴露 submodule 状态快照，供实现阶段校验分支一致性、detached HEAD 与脏工作区；但这不会改变 FEATURE_DIR 的解析规则。

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

何时使用

• 将读/写 {FEATURE_DIR}/requirements/*.md
• 不确定当前 spec pack 或出现分支/目录/.aisdlc 相关上下文错误

做法：复用已有结果，否则执行脚本

优先复用：若本会话已成功回显过 FEATURE_DIR=...，且该目录存在并含 requirements/，则直接复用并回显 FEATURE_DIR=... (reuse)。

否则：拼接 <本SKILL.md目录>/scripts/ 下的脚本绝对路径并执行，从输出中读取 FEATURE_DIR=<path> 行。

对于实现阶段调用方（如 spec-plan、spec-execute），如果脚本还输出了 SUBMODULE_SET_JSON=... 或等价字段，也应一并保留并传递给后续步骤使用。

PowerShell

powershell -NoProfile -ExecutionPolicy Bypass -File "<本SKILL.md目录>/scripts/spec-common.ps1" -SkillName "<caller-skill-name>"

Bash

"<本SKILL.md目录>/scripts/spec-common.sh" "<caller-skill-name>"

-SkillName / 第一参数：替换为当前执行的技能名（如 spec-plan）。 <本SKILL.md目录>：替换为本 SKILL.md 所在目录的绝对路径。

硬规则

• 读写 requirements/*.md 前必须先回显 FEATURE_DIR=...（复用或脚本二选一）
• 脚本失败则立即停止，不得继续写文件
• 后续路径一律以 FEATURE_DIR 值为前缀
• 若仓库存在 .gitmodules，实现阶段不得绕过脚本去“手猜” submodule 路径或分支状态

常见错误与 Red Flags

• 未传 -SkillName 或照抄 <caller-skill-name> 字面量
• 非 spec 分支（分支名不符合 {num}-{short-name}）
• 手写 .aisdlc/specs/... 路径；上下文失败后仍继续生成
• 把 submodule 分支当成新的 Spec 身份，试图用它单独推导 FEATURE_DIR