xp-gate 0.5.1

package/skills/sprint-flow/templates/emergent-issues-template.md

@@ -0,0 +1,120 @@
+# Emergent Issues Template
+
+## 使用说明
+
+此模板用于 Phase 4 (USER ACCEPTANCE) 人工验收。
+
+⚠️ 这是 AI 无法预测的 UX/质量问题，只有实际使用才能发现。
+
+---
+
+# Emergent Issues - [需求名称]
+
+## 验收元信息
+
+```yaml
+验收日期: YYYY-MM-DD
+验收阶段: Phase 4 - USER ACCEPTANCE
+验收人: [姓名]
+MVP 版本: v1.0
+Sprint ID: sprint-YYYY-MM-DD-NN
+```
+
+---
+
+## 检查清单
+
+### 1. 核心功能体验 (Core Functionality UX)
+
+- [ ] 功能是否按预期工作？
+- [ ] 输入 → 输出的流程是否流畅？
+- [ ] 边界情况处理是否正确？（空值、极限值、异常输入）
+- [ ] 错误处理是否友好？
+
+**发现的问题**:
+| 问题描述 | 严重程度 | 影响范围 | 发现场景 |
+|---------|---------|---------|---------|
+| [填写] | [Critical/Major/Minor] | [填写] | [填写] |
+
+---
+
+### 2. 多轮交互体验 (Multi-turn Interaction UX)
+
+- [ ] 多轮对话/操作是否连贯？
+- [ ] 上下文是否正确传递？
+- [ ] 用户意图理解是否准确？
+- [ ] 响应是否生硬/机械？
+
+**发现的问题**:
+| 问题描述 | 严重程度 | 影响范围 | 发现场景 |
+|---------|---------|---------|---------|
+| [填写] | [Critical/Major/Minor] | [填写] | [填写] |
+
+---
+
+### 3. 视觉/交互体验 (Visual/Interaction UX)
+
+- [ ] UI 元素是否清晰可辨？
+- [ ] 是否存在"看起来像按钮但不可点击"的元素？
+- [ ] 错误消息位置是否合理？（是否远离问题发生处）
+- [ ] 响应时间是否满意？
+- [ ] 移动端/桌面端是否一致？
+
+**发现的问题**:
+| 问题描述 | 严重程度 | 影响范围 | 发现场景 |
+|---------|---------|---------|---------|
+| [填写] | [Critical/Major/Minor] | [填写] | [填写] |
+
+---
+
+### 4. 用户认知负担 (Cognitive Load)
+
+- [ ] 用户是否容易理解如何使用？
+- [ ] 是否需要额外学习/培训？
+- [ ] 概念/术语是否一致？
+- [ ] 流程是否符合用户心智模型？
+
+**发现的问题**:
+| 问题描述 | 严重程度 | 影响范围 | 发现场景 |
+|---------|---------|---------|---------|
+| [填写] | [Critical/Major/Minor] | [填写] | [填写] |
+
+---
+
+### 5. 意外发现 (Unexpected Observations)
+
+- [ ] 是否发现了未预期的用户行为？
+- [ ] 是否发现了新需求场景？
+- [ ] 是否发现了潜在优化点？
+
+**发现的问题**:
+| 问题描述 | 严重程度 | 影响范围 | 发现场景 |
+|---------|---------|---------|---------|
+| [填写] | [Critical/Major/Minor] | [填写] | [填写] |
+
+---
+
+## Emergent Issues Summary
+
+| 总计发现问题数 | Critical | Major | Minor |
+|---------------|----------|-------|-------|
+| [填写] | [填写] | [填写] | [填写] |
+
+---
+
+## 验收结论
+
+- [ ] ✅ 验收通过，进入 Phase 5 (Ship)
+- [ ] ⚠️ 发现问题需 Sprint 2 迭代
+- [ ] ❌ 重大问题，需重新规划
+
+**验收人签名**: ________________  **日期**: ________________
+
+---
+
+## Next Step
+
+根据验收结论：
+- ✅ 验收通过 → 进入 Phase 5 (FEEDBACK) 自动执行
+- ⚠️ 发现问题 → 进入 Phase 5，记录反馈，准备 Sprint 2
+- ❌ 重大问题 → Sprint 2 回到 Phase 0 重新规划

package/skills/sprint-flow/templates/pain-document-template.md

@@ -0,0 +1,115 @@
+# Pain Document Template
+
+## 使用说明
+
+此模板用于 Phase 0 (THINK) 输出。基于 office-hours 六个强制问题验证需求真实性。
+
+---
+
+# Pain Document - [需求名称]
+
+## 元信息
+
+```yaml
+生成日期: YYYY-MM-DD
+生成阶段: Phase 0 - THINK
+来源: office-hours skill
+Sprint ID: sprint-YYYY-MM-DD-NN
+```
+
+---
+
+## 1. 需求现实 (Demand Reality)
+
+**真实用户是否真的需要这个？**
+
+[回答]
+
+**现在有什么替代方案？**
+
+[回答]
+
+**为什么他们还没有用替代方案？**
+
+[回答]
+
+---
+
+## 2. 当前状态 (Status Quo)
+
+**用户现在怎么解决这个问题？**
+
+[回答]
+
+**他们的现状有多糟糕？**
+
+[回答]
+
+---
+
+## 3. 绝望的具体性 (Desperate Specificity)
+
+**能否描述一个具体的用户场景？**
+
+[回答]
+
+**这个场景有多绝望？**
+
+[回答]
+
+---
+
+## 4. 最窄切入点 (Narrowest Wedge)
+
+**最小的可行切入点是什么？**
+
+[回答]
+
+**为什么这是"最窄"？**
+
+[回答]
+
+---
+
+## 5. 观察证据 (Observation)
+
+**你自己是否观察到这个问题？**
+
+[回答]
+
+**数据或访谈支持吗？**
+
+[回答]
+
+---
+
+## 6. 未来适配 (Future-fit)
+
+**这个需求在未来 3-5 年是否仍然存在？**
+
+[回答]
+
+**是否会被技术变化淘汰？**
+
+[回答]
+
+---
+
+## Pain Statement (一句话痛点)
+
+> [用一句话描述为什么这是真实痛点]
+
+---
+
+## Proposed Solution (建议方案)
+
+基于六个问题推导出的初步方案：
+
+[方案描述]
+
+---
+
+## Next Step
+
+- 进入 Phase 1 (PLAN) 自动执行
+- 调用 autoplan skill 进行需求评审

package/skills/sprint-flow/templates/sprint-summary-template.md

@@ -0,0 +1,120 @@
+# Sprint Summary Template
+
+## 使用说明
+
+此模板用于 Phase 6 (SHIP) 结束时生成 Sprint 总结。
+
+---
+
+# Sprint Summary - [需求名称]
+
+## Sprint 元信息
+
+```yaml
+Sprint ID: sprint-YYYY-MM-DD-NN
+开始日期: YYYY-MM-DD
+结束日期: YYYY-MM-DD
+总耗时: [X hours/days]
+MVP 版本: v1.0
+最终状态: [completed/needs-sprint-2]
+```
+
+---
+
+## 阶段执行统计
+
+| Phase | 耗时 | 状态 | 暂停次数 | 备注 |
+|-------|------|------|---------|------|
+| Phase 0: THINK | [X min] | ✅ 完成 | 0 | [备注] |
+| Phase 1: PLAN | [X min] | ✅ 完成 | [N] | [备注] |
+| Phase 2: BUILD | [X min] | ✅ 完成 | [N] | [备注] |
+| Phase 3: REVIEW | [X min] | ✅ 完成 | [N] | [备注] |
+| Phase 4: UAT | [X min] | ✅ 完成 | 1 (必须) | [备注] |
+| Phase 5: FEEDBACK | [X min] | ✅ 完成 | 0 | [备注] |
+| Phase 6: SHIP | [X min] | ✅ 完成 | [N] | [备注] |
+
+---
+
+## Skills 调用统计
+
+| Skill | 调用次数 | 结果 | 备注 |
+|-------|---------|------|------|
+| office-hours | 1 | ✅ | Pain Document 生成 |
+| autoplan | 1 | ✅/⚠️ | [taste_decisions 数量] |
+| delphi-review | [N] rounds | ✅ APPROVED | [Round 数量] |
+| specification.yaml | 1 | ✅ | specification.yaml |
+| BUILD (TDD + review) | 1 | ✅ APPROVED | [Gate 1 失败次数] |
+| test-driven-development | [N] | ✅ | [BUILD (TDD + review) 内部调用] |
+| cross-model-review | [N] rounds | ✅ APPROVED | [Round 数量] |
+| test-specification-alignment | 1 | ✅ | [覆盖率] |
+| browse | 1 | ✅ | [QA 通过] |
+| learn | 1 | ✅ | [记录数量] |
+| ship | 1 | ✅ | [PR URL] |
+| land-and-deploy | 1 | ✅ | [部署 URL] |
+| canary | 1 | ✅ | [监控正常] |
+
+---
+
+## Emergent 发现统计
+
+| 类别 | 数量 | 处理状态 | 备注 |
+|------|------|---------|------|
+| Critical | [N] | [自动 Sprint 2] | [描述] |
+| Major | [N] | [询问用户] | [描述] |
+| Minor | [N] | [可选纳入 Sprint 2] | [描述] |
+
+---
+
+## 交付物清单
+
+| 交付物 | 路径 | 状态 |
+|-------|------|------|
+| Pain Document | `.sprint-state/phase-outputs/pain-document.md` | ✅ |
+| Specification | `.sprint-state/phase-outputs/specification.yaml` | ✅ |
+| MVP v1 | `.sprint-state/phase-outputs/mvp-v1/` | ✅ |
+| Review Report | `.sprint-state/phase-outputs/review-report.md` | ✅ |
+| Emergent Issues | `.sprint-state/phase-outputs/emergent-issues.md` | ✅/⚠️ |
+| Feedback Log | `.sprint-state/phase-outputs/feedback-log.md` | ✅ |
+| Sprint Summary | `.sprint-state/phase-outputs/sprint-summary.md` | ✅ |
+
+---
+
+## 关键决策记录
+
+| 决策点 | 选项 | 选择 | 理由 |
+|-------|------|------|------|
+| [决策1] | [A/B] | [选择] | [理由] |
+| [决策2] | [A/B] | [选择] | [理由] |
+
+---
+
+## Sprint 2 建议（如有 emergent issues）
+
+```yaml
+Sprint 2 触发: [auto/user-confirm/none]
+Sprint 2 Pain Document: sprint2-pain.md
+
+Critical Issues (自动纳入):
+  - [Issue 1]
+  - [Issue 2]
+
+Major Issues (建议纳入):
+  - [Issue 1]
+
+Minor Issues (可选纳入):
+  - [Issue 1]
+```
+
+---
+
+## 下一步行动
+
+根据 Sprint 状态：
+- ✅ Sprint 完成 → 结束流程
+- ⚠️ 有 emergent issues → 提示用户是否开始 Sprint 2
+- ❌ Sprint 失败 → 记录失败原因，结束流程
+
+---
+
+**Sprint 结束时间**: YYYY-MM-DD HH:MM:SS
+**报告生成人**: sprint-flow skill

package/skills/test-specification-alignment/AGENTS.md

@@ -0,0 +1,59 @@
+# SKILLS/TEST-SPECIFICATION-ALIGNMENT KNOWLEDGE BASE
+
+**Generated:** 2026-05-02
+**Commit:** 1f6bc7d
+**Branch:** main
+
+## OVERVIEW
+Test-Specification Alignment Engine - Two-stage validation ensuring tests accurately reflect requirements and design specs.
+
+## STRUCTURE
+```
+skills/test-specification-alignment/
+├── SKILL.md              # Core alignment engine definition
+└── references/          # Supporting documentation
+```
+
+## WHERE TO LOOK
+| Task | Location | Notes |
+|------|----------|-------|
+| Core Logic | SKILL.md | Main alignment workflow |
+| Two-Stage Flow | SKILL.md | Phase 1 (align) + Phase 2 (execute) |
+
+## CODE MAP
+| Symbol | Type | Location | Refs | Role |
+|--------|------|----------|------|------|
+| Phase 1 | Align Verification | SKILL.md | N/A | Test alignment with specification |
+| Phase 2 | Execute Tests | SKILL.md | N/A | Test execution with freezes |
+| Freeze Mechanism | Constraint | SKILL.md | N/A | Prevent test modifications during Phase 2 |
+
+## CONVENTIONS
+- Phase 1 allows test modifications to align with specification
+- Phase 2 prohibits any test modifications (freeze enforced)
+- Minimum 80% alignment score required to pass
+- All @test, @intent, @covers tags must be present
+
+## ANTI-PATTERNS (THIS PROJECT)
+- Do NOT modify tests during Phase 2 execution
+- Do NOT proceed with low alignment score (<80%)
+- Do NOT skip specification validation if specification exists
+
+## UNIQUE STYLES
+- Two-phase separation (modify vs. execute)
+- Freeze/unfreeze test protection
+- YAML specification-driven validation
+- Structured JSDoc tag requirements
+
+## COMMANDS
+```bash
+# Trigger test-specification alignment
+/test-specification-alignment
+
+# Check specification alignment
+/verify-tests
+```
+
+## NOTES
+- Integrates with BUILD (TDD + review) before Arbiter review
+- Mandated before gstack-ship release
+- Uses freeze skill to lock test directories during Phase 2