feat(preset): nexusx spec-kit preset (4-phase SDD on spec-kit)

[allmonday]

Summary

把 skill/ 里的 nexusx 4-phase 方法论迁到 spec-kit preset，让用户跑标准 /speckit-specify → /speckit-plan → /speckit-tasks 时拿到 nexusx 风味的输出（Phase 0 八步访谈、nexusx Technical Context、phase-tagged tasks）。skill/ 保留不动作为 fallback。

What's bundled

presets/nexusx/ — 12 files:

文件	作用
preset.yml	manifest，提供 4 模板 + 3 命令（全 replace 策略，跟随 lean preset）
templates/constitution-template.md	8 条硬规则（lazy=noload / 实体纯净 / DTO 纯净 / UseCase 返回注解 / MCP 传输等）+ V 型验收治理
templates/spec-template.md	spec-kit 用户故事骨架 + 前置 Phase 0 需求确认纪要（实体/关系/聚合根/Service切分候选/DB选型）
templates/plan-template.md	nexusx Technical Context（DB选型 / async+sync URL / alembic / Service切分最终方案 / 是否 TS SDK）
templates/tasks-template.md	phase-first 混合：Schema → Methods → Service → 可选 SDK；每 task 带 [P1]/[P2]/[P3]/[P4]
commands/speckit.specify.md	注入 Phase 0 八步访谈，含 Service 切分强制门（Constitution IV）
commands/speckit.plan.md	注入 DB选型 / alembic / TS SDK 决策访谈；强制 Phase 0 完整性检查
commands/speckit.tasks.md	phase 标签规则 + reference doc 链接 + Phase 4 条件生成
reference/phase{1,2,3}.md	从 skill/phases/ 复制（preset 自包含；带同步头）

scripts/preset-reinstall.sh — specify preset add --dev 是 copy-based，每次源码改动需重装。脚本封装 remove + add + 验证 resolve。

Plan agent 关键修正

• wrap 不可用：原计划用 wrap 策略行间注入，Plan agent 指出 wrap 只支持 {CORE_TEMPLATE} 占位符前后追加，不能交错。改用 replace（mirror lean preset 模式）。
• preset.yml 字段名：spec-kit 把 templates 和 commands 都放在 provides.templates 下用 type: 区分，不存在 provides.commands。第一版用错字段导致命令未注册，已修。
• 006-skill-template-polish 不存在：原计划用作回归对照，实际 specs/ 里已重命名为 006-voyager-about-tab。改为建议用 007-preset-test。

Status

Preset 安装链路已验证：

✓ specify preset add --dev ./presets/nexusx  →  installed (priority 10)
✓ Templates: 7 (4 templates + 3 commands)
✓ registered_commands: claude → [speckit.specify, speckit.plan, speckit.tasks]
✓ registered_skills: [speckit-specify, speckit-plan, speckit-tasks]
✓ .claude/skills/speckit-{specify,plan,tasks}/SKILL.md → source: preset:nexusx
✓ 4 templates resolve to nexusx override (not core)

Test plan

Pre-check（已通过）:

• bash scripts/preset-reinstall.sh 退出码 0
• specify preset list 列出 nexusx
• specify preset resolve spec-template 指向 nexusx
• .claude/skills/speckit-specify/SKILL.md description 是 nexusx 文案

End-to-end（待 user 实测，Phase 0 访谈需要 user 回答）:

# 在 nexusx repo root
/speckit-specify 为 demo/blog 增加 post 评论功能

验证：

• Phase 0 八步访谈逐项发起（实体表 / ER 图 / 聚合根 / Service切分候选 / DB选型）
• Service 切分候选方案强制门触发（未选时停 SPEC_PHASE0_BLOCKED）
• DB 选型强制门触发
• specs/007-*/spec.md 包含 ## Phase 0 需求确认纪要 区块

/speckit-plan

验证：

• specs/007-*/plan.md Technical Context 含 nexusx 字段（DB 选型 / async URL / sync URL / alembic / Service 切分 / TS SDK 决策）
• Constitution Check 引用 8 条原则
• TS SDK 决策访谈发起

/speckit-tasks

验证：

• specs/007-*/tasks.md 按 Phase 1 Schema → 2 Methods → 3 Service 组织
• 每 task 带 [P1]/[P2]/[P3] phase 标签 + [USx]
• 每 phase 顶部链接 presets/nexusx/reference/phaseN.md
• TS SDK 为"否"时 Phase 4 完全省略（不留空骨架）

Open issues（非阻塞，留 v2）

• Constitution 是 LLM-advised 不是 hard-gated；运行时才报错（如 MissingReturnAnnotationError）。v2 可考虑加 phase-exit checklist 模板。
• reference/phase{1,2,3}.md 会与 skill/phases/ 漂移；已加同步头注释让 drift grep-able。
• 替换策略耦合 spec-kit 版本；pin >=0.6.0，上游命令结构改了需要手动 re-sync。

🤖 Generated with Claude Code