SuperAPI AI 工具集

spec-context

编程与开发

查看项目

更新于 10-16 08:49

技能介绍

用途:在 dlc-dev 的 Spec 流程中定位当前 spec pack(FEATURE_DIR),确保读写 requirements/*.md 时使用正确目录,防止出现看错上下文、写错文件或分支不符合规范的问题。

主要能力:以当前 Git 分支名为锚点解析 FEATURE_DIR,禁止猜路径。分支格式为:Spec 分支 {num}-{short-name}(如 001-user-auth)对应 FEATURE_DIR=.aidlc/specs/<分支名>;任务分支 {num}-{short-name}/T1-task-slug(如 001-user-auth/T1-api)仍指向同一 Spec Pack,不指向任务子目录。脚本输出可能包含 TASK_WORK_BRANCH、TASK_DIR、TASK_PACK_DIR。若仓库含 .gitmodules,还会额外暴露 submodule 状态快照,供实现阶段校验分支一致性、detached HEAD 与脏工作区,但不改变 FEATURE_DIR 解析规则。

使用方式:可优先复用本会话已成功回显且目录存在并含 requirements/ 的 FEATURE_DIR;否则执行脚本并读取输出中的 FEATURE_DIR=<path> 行。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>"。

硬规则:读写 requirements/*.md 前必须先回显 FEATURE_DIR;脚本失败立即停止;后续路径一律以 FEATURE_DIR 为前缀;存在 .gitmodules 时实现阶段不得手猜 submodule 路径或分支状态。

适用场景:需要在 Spec 流程中定位当前 spec pack,或出现分支、目录、.aidlc 相关上下文错误时。

限制:仅适用于符合 {num}-{short-name} 或 {num}-{short-name}/T1-slug 的分支;其他分支不适用。