Agent Skills
› NeverSight/learn-skills.dev
› ny-sdd-workflow
ny-sdd-workflow
GitHub用于在项目初始化或更新时安装 SDD Workflow v1.0.3，自动配置 AGENTS.md、CLAUDE.md 及多 AI 工具集成。支持显式安装与开发意图兜底触发，具备动态规则加载、自审机制及完善的交互回滚功能。
Trigger Scenarios
用户说'安装 SDD'、'安装 AGENTS'、'安装 AI 工作流'、'配置开发规范'
用户运行 `/sdd-init` 命令
用户说'启动工作流'、'开始开发'且项目根目录无 `AGENTS.md`
新项目需要建立 AI 编码工作流规范时
用户说'更新工作流'、'更新 SDD'
Install
npx skills add NeverSight/learn-skills.dev --skill ny-sdd-workflow -g -y
SKILL.md
Frontmatter
{
"name": "ny-sdd-workflow",
"description": "安装 SDD Workflow v1.0.3 开发工作流到项目中。自动解析 skill 安装路径，生成 AGENTS.md（核心规则 + 路径已烧录）， 同时生成 CLAUDE.md（symlink → AGENTS.md，Claude Code 自动读取）， 阶段规则文件（rules\/）保留在 skill 目录按需读取，并可选同步到其他 AI 工具。\n**架构**：G 系列全局规则 + §1~§4 阶段编号 + 流程声明头机制（含**四值 blocking** true\/false\/gated\/audit-required）+ 动态加载 + **执行自审统一机制**（跨对话开局 + 单会话每节进入两个触发点）+ **context.md `produced` 字段**（产物路径 + 锚点 + SHA-256 前 8 位，仅 §2.4 \/ §3.6 \/ §3.7 三章强制）+ **审计起手清单**（§3.6 进入时 ≥3 怀疑点 + 验证）+ **上节产物回灌**（§2.5 \/ §3.7 \/ §3.8 进入时 cat 上节产物 + 哈希校验）+ 13 个 Slash Commands，兼容多 AI 工具。\n**必须在以下场景触发：** - 用户说\"安装 SDD\"、\"安装 AGENTS\"、\"安装 AI 工作流\"、\"配置开发规范\" - 用户运行 `\/sdd-init` 命令 - 用户说\"启动工作流\"、\"开始开发\" **且项目根目录无 `AGENTS.md`**（兜底：未装 SDD 时帮用户先装好；安装完成后**自动接续 G0 对话初始化**，用户无需再触发一次\"启动工作流\"） - 新项目需要建立 AI 编码工作流规范时 - 用户说\"更新工作流\"、\"更新 SDD\"\n**注意**： - Claude Code 内置的 \/init 命令（生成独立 CLAUDE.md）会覆盖本工作流生成的 CLAUDE.md symlink，请勿混用。 - 用户说\"启动工作流\"或运行 `\/sdd-start`：默认是**进入项目开发流程**（G0 对话初始化）。仅当 AGENTS.md 不存在时才转入本 Skill 完成基础设施安装；**自然语言\"启动工作流\"触发的兜底安装完成后自动接续 G0 首次路径**（详见 Step 0 入口类型检测 + Step 7 路由分支），用户无需重复触发；仅 `\/sdd-init` 显式安装才保留\"装完停下等用户验证\"的两阶段设计。\n产出：① 项目根目录 AGENTS.md（{SKILL_DIR} 已替换为实际路径）② CLAUDE.md（symlink → AGENTS.md，Windows 用复制兜底）③ 各 AI 工具指令文件 symlink ④ Slash Commands 安装（用户级 \/ 项目级 \/ 跳过 三选一）⑤ 初始化状态报告"
}
SDD Workflow 初始化 Skill
本 skill 将 SDD Workflow v1.0.3 安装到当前项目，自动适配多 AI 工具。
安装过程多轮交互处理
SKILL.md A 分支安装期间，AI 与用户有多轮交互（Step 3 同步工具、Step 4 命令位置等）。用户回复偏离当前 Step 的预期选项时（非该 Step 列出的 A/B/C/D 答案，且非"取消" / "继续"等明确指令），AI 必须：
- 暂停当前 Step，不强行解析用户回复为答案
- 按 G2 停车信号格式输出：列出当前 Step 编号 + 用户回复内容 + 建议处理方式
- 提供三选一让用户确认：
- A. 继续当前 Step（请用户重新回复对应选项）
- B. 取消安装（回滚已生成的文件，输出已执行步骤摘要）
- C. 跳到指定 Step（用户指定跳转目标，如"跳到 Step 5"）
- 等待用户明确选择后再推进
取消时的回滚（B 选项）：
- 已生成 AGENTS.md → 删除
- 已创建 CLAUDE.md symlink → 删除
- 已创建其他 AI 工具 symlink → 删除
- 已安装 slash commands → 删除（仅本次安装新增的）
- 不删除 .docs/ / .project/ 等用户目录（即便是 G0.2 创建的，可能含用户内容）
- 输出回滚摘要让用户确认
动态加载架构：
AGENTS.md（始终加载）
└── G0 对话初始化 + G1 写码门禁 + G2 停车信号 + G3 未覆盖场景兜底 + 阶段路由表
↓ AI 根据 context.md 状态按需读取
{SKILL_DIR}/rules/phase-init.md §1 项目启动
{SKILL_DIR}/rules/phase-spec.md §2 需求/设计/评审
{SKILL_DIR}/rules/phase-coding.md §3 编码变更通道（§3.1~§3.11）
{SKILL_DIR}/rules/phase-archive.md §4 归档
{SKILL_DIR}/rules/quality-standards.md 审计标准（审计时读取）
{SKILL_DIR}/rules/skill-routing.md Skill 路由（安装/调用时读取）
{SKILL_DIR}/rules/slash-commands.md Slash Commands 详细路由（用户触发 /sdd-* 命令时读取）
{SKILL_DIR}/rules/project-structure.md .project 完整目录结构（用户询问 / 追溯具体路径时读取）
{SKILL_DIR}/templates/project-profile.tpl.md 初始化 profile 时读取
{SKILL_DIR}/templates/project-overview.tpl.md 生成 overview 时读取
外部 Skill（§1.2 按需调用）：
reverse-scan Skill 深度业务代码扫描（知识卡片+调用图+模块地图+逆向DES/REQ）
关键机制：安装时 {SKILL_DIR} 被替换为实际路径（本地安装→相对路径，全局安装→绝对路径），AGENTS.md 中写死真实值，AI 可直接读取。
第一步：确认操作类型
询问用户：
【SDD Workflow】
请选择操作：
A. 初始化（首次安装，生成 AGENTS.md + 各工具 symlink）
B. 更新（更新 AGENTS.md 到最新版本）
C. 查看状态（检查各文件安装情况）
D. 卸载（清理 symlink，保留 AGENTS.md）
第二步：执行对应操作
A. 初始化
Step 0：入口类型检测
执行 A 分支前，AI 必须先识别原始触发入口（影响 Step 6 报告内容 + Step 7 是否自动接续 G0）：
| 入口类型 | 触发判定 | 后续行为 |
|---|---|---|
| install（显式安装意图） | 用户运行 /sdd-init；或自然语言含"安装 SDD"/"安装工作流"/"安装 AGENTS"/"配置开发规范"等明显安装词 |
Step 6 输出"下一步：运行 /sdd-start"提示，Step 7 停下不接续（保留两阶段设计，让用户验证安装结果） |
| develop（开发意图被兜底引导） | 用户自然语言含"启动工作流"/"开始开发"/"开始项目"；或运行 /sdd-start（场景 A 自动转入本 SKILL.md，与自然语言路径一致），且项目根无 AGENTS.md 被兜底进入 |
Step 6 输出"已自动接续 G0"提示，Step 7 自动继续执行 G0 首次路径（避免用户重复触发） |
| ambiguous（无法判定） | 用户首条消息既不含安装词也不含开发词（罕见，如直接说"运行 SKILL.md A 分支"） | 按 install 处理（保守，等用户确认） |
| 兼有 install + develop 词 | 用户首条消息同时含安装词（"安装"/"配置"）和开发词（"启动"/"开始开发"），如"安装并启动 SDD 工作流" | 按 install 处理（保守）——让用户验证安装结果后再触发开发；安装报告里特别标注"检测到你同时表达了安装与开发意图，本次按 install 处理，安装完后请确认无误再说'启动工作流'" |
AI 必须在本次会话内记忆此 entry_type 直到 Step 7，作为路由依据。
Step 1：确定 skill 安装路径
检测本 skill 的安装位置，用于生成 AGENTS.md 中的文件引用路径。检测必须基于 SKILL.md 实际存在性（空骨架目录不算有效安装），按以下顺序判定：
-
检测项目本地安装：
# 路径有效性 = 目录存在 + SKILL.md 实际可读 [ -f "$(pwd)/.agents/skills/ny-sdd-workflow/SKILL.md" ]- ✅ 通过 → 使用相对路径
.agents/skills/ny-sdd-workflow - ❌ 不通过（含"目录存在但 SKILL.md 缺失"的空骨架场景——例如
npx skills add ... -a claude-code误创建的空.agents/目录）→ 视为非本地安装，回退到第 2 步
- ✅ 通过 → 使用相对路径
-
检测全局安装（回退路径）：
# 用户级标准位置 [ -f "$HOME/.claude/skills/ny-sdd-workflow/SKILL.md" ]- ✅ 通过 → 使用完整展开的绝对路径（用
echo $HOME获取，禁止~） - ❌ 不通过 → 报错并退出：「Skill 未正确安装：本地
.agents/skills/ny-sdd-workflow/与全局~/.claude/skills/ny-sdd-workflow/均无 SKILL.md。请先运行npx skills add https://git.nykjsrv.cn/ai-coding/skills.git --skill ny-sdd-workflow --yes完成安装」
- ✅ 通过 → 使用完整展开的绝对路径（用
-
空骨架告知（不删除）：若第 1 步检测到本地路径目录存在但 SKILL.md 缺失（明确判定为空骨架），在 Step 6 初始化报告中追加一行提示：
⚠️ 检测到 .agents/skills/ny-sdd-workflow/ 为空骨架（无 SKILL.md），已自动回退到全局安装路径。 这通常是 `npx skills add ... -a claude-code` 误建的占位目录，可手动清理： rm -rf .agents/skills/ny-sdd-workflow （或保留亦无影响，工作流不会再误判）
最终路径形态：
- 项目本地安装（路径校验通过）→ 使用相对路径：
.agents/skills/ny-sdd-workflow - 全局安装（本地路径不通过的回退）→ 使用完整展开的绝对路径
绝对路径必须完整展开（最高优先级约束）：
- ❌ 禁止写成
~/.claude/skills/ny-sdd-workflow（~在 Read 工具中不展开，会导致后续读取失败）- ✅ 必须写成
/Users/{username}/.claude/skills/ny-sdd-workflow（macOS）//home/{username}/.claude/skills/ny-sdd-workflow（Linux）/C:\Users\{username}\.claude\skills\ny-sdd-workflow（Windows）- 检测方法：用 Bash 工具运行
echo $HOME或pwd（在 skill 目录内），获取完整展开后的绝对路径- 走本地 CLI 路径（
node <SDD_DIR>/bin/cli.js init）时，cli.js 的path.resolve()自动完整展开，无需手动处理；走 SKILL.md 路径（AI 对话中说"安装 SDD"）时，AI 必须用 Bash 工具显式获取完整展开后的路径再写入 AGENTS.md
Step 2：生成 AGENTS.md + CLAUDE.md
检查项目根目录是否已存在 AGENTS.md：
- 已存在 → 提示用户「AGENTS.md 已存在，跳过。如需更新请选 B」
- 不存在 → 读取本 skill 目录下的
templates/AGENTS.md，将其中所有{SKILL_DIR}替换为 Step 1 确定的实际路径，写入项目根目录AGENTS.md
生成 CLAUDE.md（自动，无需用户选择）：
- macOS/Linux：创建 symlink
CLAUDE.md → AGENTS.md - Windows：复制
cp AGENTS.md CLAUDE.md - 若 CLAUDE.md 已存在且为非 symlink → 跳过并提示（避免覆盖用户自定义内容）
AGENTS_FILE="$(pwd)/AGENTS.md"
# 创建 CLAUDE.md symlink（macOS/Linux），Windows 用 cp 兜底
if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "cygwin" || "$OSTYPE" == "win32" ]]; then
[ ! -f CLAUDE.md ] && cp "$AGENTS_FILE" CLAUDE.md && echo "✅ CLAUDE.md (复制自 AGENTS.md)"
else
[ ! -e CLAUDE.md ] && ln -s "$AGENTS_FILE" CLAUDE.md && echo "✅ CLAUDE.md → AGENTS.md (symlink)"
fi
Step 3：询问用户是否同步到其他 AI 工具
【AI 工具同步】
是否将 AGENTS.md 同步到其他 AI 编码工具？（创建 symlink 指向 AGENTS.md）
请选择需要同步的工具（多选，用逗号分隔，或输入 A 全选，N 跳过）：
1. Cursor → .cursor/rules/ny-sdd-workflow.md
2. GitHub Copilot → .github/copilot-instructions.md
3. Cline → .clinerules
4. Windsurf → .windsurfrules
5. Augment → .augment/rules/ny-sdd-workflow.md
6. Continue → .continue/rules/ny-sdd-workflow.md
用户选择后，仅为选中的工具创建 symlink：
AGENTS_FILE="$(pwd)/AGENTS.md"
# Cursor
mkdir -p .cursor/rules && [ ! -e .cursor/rules/ny-sdd-workflow.md ] && ln -s "$AGENTS_FILE" .cursor/rules/ny-sdd-workflow.md
# GitHub Copilot
mkdir -p .github && [ ! -e .github/copilot-instructions.md ] && ln -s "$AGENTS_FILE" .github/copilot-instructions.md
# Cline
[ ! -e .clinerules ] && ln -s "$AGENTS_FILE" .clinerules
# Windsurf
[ ! -e .windsurfrules ] && ln -s "$AGENTS_FILE" .windsurfrules
# Augment
mkdir -p .augment/rules && [ ! -e .augment/rules/ny-sdd-workflow.md ] && ln -s "$AGENTS_FILE" .augment/rules/ny-sdd-workflow.md
# Continue
mkdir -p .continue/rules && [ ! -e .continue/rules/ny-sdd-workflow.md ] && ln -s "$AGENTS_FILE" .continue/rules/ny-sdd-workflow.md
注意：其他 AI 工具（Cursor/Copilot 等）只能读取 AGENTS.md 中的核心规则（~170行）。 动态加载阶段文件的能力仅 Claude Code / Codex 支持。 核心规则（G1 门禁 + G2 停车信号）已足够保障其他工具的基本流程。
Step 4：Slash Commands 安装（策略 C — 用户级 / 项目级 / 跳过）
根据 Step 1 检测到的 SKILL_DIR 类型，给出推荐选项：
【Slash Commands 安装位置】
检测到当前 SDD 安装位置：{SKILL_DIR}
→ 类型：{全局安装 / 项目本地安装}
请选择 slash 命令安装位置：
A. 用户级 ~/.claude/commands/（推荐：所有项目可用，一次安装永久可见）
B. 项目级 .claude/commands/（仅当前项目可见）
C. 跳过（不安装命令，仅用自然语言触发）
默认推荐：
· 全局安装 → A（用户级）
· 项目本地安装 → B（项目级）
用户选择后，对 13 个命令文件创建 symlink（Windows 兜底为 cp）：
AI 执行前：将下方 bash 脚本中的
{SKILL_DIR}替换为 Step 1 确定的实际路径（绝对路径或相对路径，与 AGENTS.md 中烧录的值一致）。
COMMANDS_SRC="{SKILL_DIR}/.claude/commands" # ← AI 替换为实际路径
# A. 用户级
if [ "$CHOICE" = "A" ]; then
mkdir -p ~/.claude/commands
for f in "$COMMANDS_SRC"/sdd-*.md; do
name=$(basename "$f")
[ ! -e "$HOME/.claude/commands/$name" ] && ln -s "$f" "$HOME/.claude/commands/$name"
done
fi
# B. 项目级
if [ "$CHOICE" = "B" ]; then
mkdir -p .claude/commands
for f in "$COMMANDS_SRC"/sdd-*.md; do
name=$(basename "$f")
[ ! -e ".claude/commands/$name" ] && ln -s "$f" ".claude/commands/$name"
done
fi
已存在检测：
- A 选项：若
~/.claude/commands/sdd-*.md已部分/全部存在 → 询问「检测到部分命令已存在（可能其他项目已安装），是否覆盖？」 - B 选项：若
.claude/commands/sdd-*.md已存在且非 symlink → 跳过该文件并提示
Slash Commands 清单（13 个）：
- 流程触发类（4 个）：
sdd-init/sdd-start/sdd-prd-change/sdd-bug-fix - 工具触发类（9 个）：
sdd-prd-audit/sdd-front-context/sdd-back-context/sdd-frontend-standards/sdd-java-create/sdd-wap-create/sdd-reverse-scan/sdd-test-case/sdd-unit-test
⚠️ 重启提示（创建 symlink 后必须明确告知用户）：
Slash 命令安装完成后，AI 必须立即输出以下提示：
⚠️ Slash 命令 symlink 已创建（13 个）
Claude Code 启动时缓存了命令列表，新装命令需**重启 Claude Code** 后才能识别。
重启前可用自然语言获得同等效果，例如：
· "启动工作流" = /sdd-start
· "需求变了" = /sdd-prd-change
· "修复 bug" = /sdd-bug-fix
· "生成功能测试用例" = /sdd-test-case
· "生成单元测试" = /sdd-unit-test
（完整 13 个命令 + 详细路由见 {SKILL_DIR}/rules/slash-commands.md）
Step 5：输出 .gitignore 建议（仅在创建了 symlink 时提示）
# SDD Workflow symlink（由 ny-sdd-workflow skill 生成，不提交）
.cursorrules
.clinerules
.windsurfrules
# 项目级 slash commands（如选择策略 B）— 是否提交按团队约定
# .claude/commands/sdd-*.md
# AGENTS.md 需要提交（源文件）
Step 6：输出初始化报告
报告头部共用，"下一步"段按 Step 0 检测的 entry_type 分支：
【SDD Workflow v1.0.3 安装完成】
✅ AGENTS.md（核心规则 G0~G3 + 编号流程规约，始终加载）
✅ CLAUDE.md → AGENTS.md（symlink，Claude Code 自动读取）
✅ 阶段规则文件位于：{实际 skill 路径}/rules/（§1~§4 按需加载）
{用户选择的 AI 工具列表}
{未选择的 AI 工具}
✅ Slash Commands（{用户级 ~/.claude/commands/ / 项目级 .claude/commands/ / 已跳过}）
- 流程：/sdd-init /sdd-start /sdd-prd-change /sdd-bug-fix
- 工具：/sdd-prd-audit /sdd-front-context /sdd-back-context /sdd-frontend-standards
/sdd-java-create /sdd-wap-create /sdd-reverse-scan /sdd-test-case /sdd-unit-test
入口来源：{install / develop / ambiguous}
entry_type = install 时（显式安装意图，保留两阶段设计）：
下一步：
· 运行 /sdd-start 进入此项目的开发流程（或直接说"启动工作流"）
· 阶段规则按需动态加载，无需一次性读取全部内容
· 如需定制项目铁律，编辑 .project/specs/rules/project-profile.md
entry_type = develop 时（开发意图被兜底引导，自动接续 G0）：
下一步：
· 基础设施已就绪，正在自动接续 G0 对话初始化（无需你再次触发）
· 阶段规则按需动态加载，无需一次性读取全部内容
· 如需定制项目铁律，编辑 .project/specs/rules/project-profile.md
· 若想中断接续（先验证安装结果），直接说"等等"打断 AI 即可
entry_type = ambiguous 时：按 install 文案输出。
Step 7：路由分支
按 Step 0 检测的 entry_type 决定本 Skill 执行结束后的行为：
- entry_type = install / ambiguous：本 Skill 执行结束，等待用户后续指令（用户可自由验证安装结果，确认无误后运行 /sdd-start 或自然语言"启动工作流"进入 G0）
- entry_type = develop：本 Skill 输出 Step 6 报告后不停止，立即接续以下动作：
-
输出过渡提示一行：
【自动接续 G0 对话初始化】（原始触发：用户说"启动工作流"，已消费，不再作为待处理输入） -
直接进入 AGENTS.md G0 首次路径（按场景 B 路由）：G0.1 项目类型确认 → G0.2 目录骨架初始化（已存在跳过）→ G0.3 文档补充确认 → G0.5 阶段路由
-
G0.0 用户输入预处理段中的"暂存用户首条消息"动作：原始消息"启动工作流"视为已消费的触发词，不再作为「待处理输入」；若用户的首条消息同时含项目特征（如"启动工作流，做个砍价小程序"），则**项目特征部分作为「待处理输入」**保留，按 G0.1 模式 A 推断模式输出
项目特征提取规则（确定性）：
- 触发词列表（按完整匹配优先，匹配后从原文移除）：
启动工作流/开始开发/开始项目/开始 SDD//sdd-start/安装 SDD/安装工作流/安装 AGENTS - 去除触发词后，剥离首尾标点（
，。、,.等）和空白字符 - 剩余文本作为「项目特征片段」保留为 G0.1 模式 A 的输入
- 剩余文本为空 / 仅含通用问候词（"你好" / "请帮我" / "麻烦" 等）→ 视为模式 B（无项目特征），G0.1 走模式 B 文案
- 示例：
- 输入
启动工作流，做个砍价小程序→ 提取做个砍价小程序 - 输入
安装 SDD 然后帮我搭 Vue3 项目→ 提取然后帮我搭 Vue3 项目→ 进一步去除"然后"等连接词 →帮我搭 Vue3 项目 - 输入
/sdd-start→ 剩余空 → 模式 B - 输入
启动工作流，你好啊→ 提取你好啊→ 仅问候 → 模式 B
- 输入
- 触发词列表（按完整匹配优先，匹配后从原文移除）：
-
进入 G0.1 等任何 §N.N 章节时，仍受 G0.5 阶段执行约束（输出流程声明头、执行自审等所有约束）
-
安装异常中断时的兜底：
- Step 1~5 任一步执行失败（路径检测失败 / 文件已存在冲突 / symlink 创建失败等）→ 停下报错，无论 entry_type 是什么都不进入 Step 7 接续；输出错误原因 + 修复建议，等待用户处理
- Step 3/Step 4 用户选"N 跳过"或局部"取消"是合法局部跳过，不视为失败，正常进入 Step 6 + Step 7
B. 更新
- 重新确定 skill 路径（同 Step 1）
- 备份旧文件：
cp AGENTS.md AGENTS.md.bak - 读取
templates/AGENTS.md，替换{SKILL_DIR}，覆盖写入项目根目录AGENTS.md - Slash Commands 同步：检查
~/.claude/commands/与.claude/commands/中的sdd-*.mdsymlink 是否完整：- 若已有 symlink → 自动同步到最新版本（symlink 指向 skill 源文件，无需重建）
- 若部分缺失 → 询问用户是否补齐（默认推荐补齐）
- 提示：「AGENTS.md 已更新到 v1.0.3，旧版已备份为 AGENTS.md.bak。CLAUDE.md (symlink) 自动同步，Windows 需重新复制。其他工具 symlink 自动同步所有工具与 slash commands」
C. 查看状态
echo "=== 核心文件 ==="
echo "AGENTS.md: $([ -f AGENTS.md ] && echo '✅ 存在' || echo '❌ 不存在')"
if [ -L CLAUDE.md ]; then echo "CLAUDE.md: ✅ symlink → AGENTS.md"
elif [ -f CLAUDE.md ]; then echo "CLAUDE.md: ⚠️ 文件（非 symlink，可能为用户自定义）"
else echo "CLAUDE.md: ❌ 不存在"
fi
echo ""
echo "=== Skill 目录 ==="
# 检查 rules/ 和 templates/ 是否完整
SKILL_DIR=".agents/skills/ny-sdd-workflow"
for f in rules/phase-init.md rules/phase-spec.md rules/phase-coding.md rules/phase-archive.md rules/quality-standards.md rules/skill-routing.md rules/slash-commands.md rules/project-structure.md templates/project-profile.tpl.md templates/project-overview.tpl.md; do
echo "$SKILL_DIR/$f: $([ -f "$SKILL_DIR/$f" ] && echo '✅' || echo '❌')"
done
echo ""
echo "=== AI 工具同步 ==="
for f in .cursor/rules/ny-sdd-workflow.md .github/copilot-instructions.md .clinerules .windsurfrules .augment/rules/ny-sdd-workflow.md .continue/rules/ny-sdd-workflow.md; do
if [ -L "$f" ]; then echo "$f: ✅ symlink"
elif [ -f "$f" ]; then echo "$f: ⚠️ 文件（非 symlink）"
else echo "$f: ❌ 未安装"
fi
done
echo ""
echo "=== Slash Commands ==="
COMMANDS=(sdd-init sdd-start sdd-prd-change sdd-bug-fix sdd-prd-audit sdd-front-context sdd-back-context sdd-frontend-standards sdd-java-create sdd-wap-create sdd-reverse-scan sdd-test-case sdd-unit-test)
echo "[用户级 ~/.claude/commands/]"
for c in "${COMMANDS[@]}"; do
f="$HOME/.claude/commands/$c.md"
if [ -L "$f" ]; then echo " $c.md: ✅ symlink"
elif [ -f "$f" ]; then echo " $c.md: ⚠️ 文件（非 symlink）"
else echo " $c.md: ❌ 未安装"
fi
done
echo "[项目级 .claude/commands/]"
for c in "${COMMANDS[@]}"; do
f=".claude/commands/$c.md"
if [ -L "$f" ]; then echo " $c.md: ✅ symlink"
elif [ -f "$f" ]; then echo " $c.md: ⚠️ 文件（非 symlink）"
else echo " $c.md: ❌ 未安装"
fi
done
D. 卸载
# 1. AI 工具 symlink
for f in .cursor/rules/ny-sdd-workflow.md .github/copilot-instructions.md .clinerules .windsurfrules .augment/rules/ny-sdd-workflow.md .continue/rules/ny-sdd-workflow.md; do
[ -L "$f" ] && rm "$f" && echo "🗑 $f"
done
# 2. 项目级 Slash Commands（默认随 AGENTS.md 卸载一起清理）
COMMANDS=(sdd-init sdd-start sdd-prd-change sdd-bug-fix sdd-prd-audit sdd-front-context sdd-back-context sdd-frontend-standards sdd-java-create sdd-wap-create sdd-reverse-scan sdd-test-case sdd-unit-test)
for c in "${COMMANDS[@]}"; do
f=".claude/commands/$c.md"
[ -L "$f" ] && rm "$f" && echo "🗑 $f"
done
# 3. 用户级 Slash Commands（默认保留，需用户主动确认是否卸载）
echo ""
echo "用户级 Slash Commands（~/.claude/commands/sdd-*.md）默认保留，因可能被其他项目使用。"
echo "如需卸载，请手动确认后执行："
echo " for c in ${COMMANDS[@]}; do f=\"\$HOME/.claude/commands/\$c.md\"; [ -L \"\$f\" ] && rm \"\$f\"; done"
echo ""
echo "AGENTS.md 已保留"
# CLAUDE.md 清理：symlink 则删除，普通文件则保留（可能为用户自定义）
if [ -L CLAUDE.md ]; then
rm CLAUDE.md && echo "🗑 CLAUDE.md (symlink 已移除)"
elif [ -f CLAUDE.md ]; then
echo "CLAUDE.md 保留（非 symlink，可能为用户自定义内容）"
fi
注意事项
- 路径依赖：AGENTS.md 中的路径指向 skill 安装目录。skill 被删除后 AI 会提示"文件不存在"，重新安装即可恢复
- Windows 兼容：不支持 symlink，AI 工具同步与 Slash Commands 安装自动改用文件复制（
cp），更新时需重新执行 - 不覆盖：AGENTS.md / CLAUDE.md 已存在时跳过；各工具指令文件、slash commands 已存在且非 symlink 时跳过并提示
- Git 提交：AGENTS.md 需要提交；CLAUDE.md（symlink → AGENTS.md）需要提交；其他 symlink 文件（.clinerules 等）不提交；项目级 slash commands（
.claude/commands/sdd-*.md）按团队约定决定 - 不要手动改 rules/ 和 tools/：skill 目录中的 rules/、templates/、tools/、.claude/commands/ 通过更新 ny-sdd-workflow 整包更新，手动修改会被覆盖
- 其他 AI 工具限制：Cursor/Copilot 等只能读 AGENTS.md 的核心规则（G0 对话初始化 + G1 门禁 + G2 停车 + G3 兜底），无法动态加载阶段文件（§1~§4）及其流程声明头，也不识别 slash commands。完整体验需 Claude Code / Codex
- Slash Commands 边界：
/sdd-init= 装"地基"（一次性，等价本 SKILL.md）；/sdd-start= 上"工地"（进入 G0 对话初始化，开始/恢复项目开发）。两者不可混淆
Version History
- e0220ca Current 2026-07-05 21:30
Dependencies
-
suggested
... -
suggested
https://git.nykjsrv.cn/ai-coding/skills.git
