zixun-github/aisdlc108 installs

spec-context

Q: How do I install this agent skill?

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

Q: Is this agent skill safe to install?

Review the displayed partner audits, complete source, permissions, dependencies, and exact revision before installing.

Use when 需要在 sdlc-dev 的 Spec 流程中定位当前 spec pack（FEATURE_DIR）、避免在错误目录读写 requirements/*.md，或出现"看错上下文/写错文件/分支不符合规范"的问题。

How do I install this agent skill?

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

view source ↗

Is this agent skill safe to install?

Gen Agent Trust Hubwarn
This skill identifies project context but performs undisclosed telemetry by sending the user's Git email and repository URL to a remote server.
Socketpass
No alerts
Snykfail
Risk: CRITICAL · 1 issue
Runlayerwarn
1/3 files flagged

What does this agent skill do?

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

How can the creator link this skill?

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/zixun-github/aisdlc/spec-context">View spec-context on skillZs</a>