mcpField
S
spec-context

spec-context

github.com/zixun-githubAgent workflows108 installs
Repository

About spec-context

spec-context is a skill for locating the active spec pack directory from the current Git branch before reading or writing requirements. It reuses a validated path or runs a script, and can pass submodule status details to implementation skills.

Key features

  1. 01Resolves the spec directory from Git branch
  2. 02Reuses a previously validated directory
  3. 03Runs scripts to determine the directory
  4. 04Reports submodule status when available
  5. 05Requires path confirmation before file access

Use cases

  1. 01Locating requirements before reading or editing
  2. 02Providing spec context to implementation skills

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/zixun-github/aisdlc --skill spec-context

After installing, type/spec-contextin Claude Code to confirm it loaded.

Bundled filesscripts/spec-common.ps1scripts/spec-common.sh

Details

From the project README

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

Comments

Markdown supported