universal-dev-standards 5.17.0 → 6.1.0

package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md

@@ -0,0 +1,296 @@
+---
+source: skills/dev-methodology/runtime.md
+source_version: 1.0.0
+translation_version: 1.0.0
+status: current
+---
+
+# Methodology Runtime 指南
+
+> **语言**: [English](../../../../skills/dev-methodology/runtime.md) | 简体中文
+
+> [!WARNING]
+> **实验性功能 / Experimental Feature**
+>
+> 此功能正在积极开发中，可能在 v4.0 中有重大变更。
+> This feature is under active development and may change significantly in v4.0.
+
+**版本**: 1.0.0
+**最后更新**: 2026-01-12
+
+---
+
+## 概览
+
+本文档定义 AI 助手在某个开发 methodology 启用时应有的行为。它提供 phase 跟踪、checkpoint 处理及用户交互的指引。
+
+---
+
+## AI 行为规格
+
+### 1. Context 感知
+
+当某个 methodology 启用时，AI 应该：
+
+- **始终知道当前的 phase**
+- **在响应中显示 phase 指示器**
+- **建议符合该 phase 的动作**
+
+#### Phase 状态显示
+
+在相关响应的开头加入 methodology 状态：
+
+```
+┌────────────────────────────────────────────────┐
+│ 📋 Methodology: TDD                             │
+│ 📍 Phase: 🔴 RED (writing failing test)         │
+│ ⏱️  Duration: 3 minutes                         │
+└────────────────────────────────────────────────┘
+```
+
+### 2. 主动指引
+
+根据当前的 phase 提供符合 context 的建议：
+
+```markdown
+**Current Phase: 🔴 RED (TDD)**
+
+You're writing a failing test for: user login validation
+
+**Next step**: Write a test that describes the expected behavior.
+
+Would you like me to:
+1. Generate a test skeleton
+2. Show TDD best practices for this scenario
+3. Continue with your manual approach
+```
+
+### 3. Phase 转换检测
+
+监控那些代表 phase 转换的条件：
+
+| Signal | Transition |
+|--------|------------|
+| Test 执行失败 | RED → ready for GREEN |
+| 所有 test 通过 | GREEN → ready for REFACTOR |
+| 用户确认 refactor 完成 | REFACTOR → next cycle or DONE |
+| 时间超过 phase duration | 显示提醒 |
+| 检测到 Git commit | 重置 phase 计时器 |
+
+### 4. Checkpoint 行为
+
+当 checkpoint 条件触发时，显示 checkpoint 通知：
+
+```
+┌────────────────────────────────────────────────┐
+│ 🔔 Methodology Checkpoint                       │
+├────────────────────────────────────────────────┤
+│ GREEN phase completed                          │
+│                                                │
+│ Checklist Status:                              │
+│   ✅ Minimum code written                      │
+│   ✅ Test passes                               │
+│   ✅ All other tests pass                      │
+│   ⬜ (Optional) Consider edge cases            │
+│                                                │
+│ Change Statistics:                             │
+│   - Files: 3                                   │
+│   - Added: 45 lines                            │
+│   - Deleted: 2 lines                           │
+│                                                │
+│ Suggested commit:                              │
+│   test(auth): add email validation test        │
+│   feat(auth): implement email validation       │
+│                                                │
+│ Options:                                       │
+│   [1] Commit now (show git commands)           │
+│   [2] Continue to REFACTOR phase               │
+│   [3] View detailed changes                    │
+└────────────────────────────────────────────────┘
+```
+
+### 5. Skip 跟踪
+
+跟踪连续的 skip 并适当地警告：
+
+| Skip Count | Action |
+|------------|--------|
+| 1-2 | 不采取动作，记录 skip |
+| 3 | 警告通知 |
+| 4+ | 强烈警告，建议 commit |
+
+#### Skip 警告显示
+
+```
+┌────────────────────────────────────────────────┐
+│ ⚠️ Skip Warning                                 │
+├────────────────────────────────────────────────┤
+│ You have skipped check-in 3 times consecutively│
+│                                                │
+│ Current accumulated changes:                   │
+│   - Files: 8                                   │
+│   - Added: 320 lines                           │
+│   - Deleted: 45 lines                          │
+│                                                │
+│ Recommendation: Commit your changes now to     │
+│ avoid losing work and maintain atomic commits. │
+│                                                │
+│ [1] Commit now  [2] Skip anyway  [3] View diff │
+└────────────────────────────────────────────────┘
+```
+
+---
+
+## Methodology 检测
+
+### 自动检测
+
+AI 应从以下来源检测 methodology context：
+
+1. **Manifest 配置**
+   ```json
+   // .standards/manifest.json
+   { "methodology": { "active": "tdd" } }
+   ```
+
+2. **关键字检测**
+   - "Let's use TDD for this"
+   - "Write a failing test first"
+   - "Given-When-Then"
+   - "Create a spec for this change"
+
+3. **命令调用**
+   - `/tdd`, `/bdd`, `/sdd`, `/atdd`
+   - `/methodology switch <id>`
+
+### 加载 Methodology 定义
+
+```
+Methodology Loading Priority:
+1. Custom: .standards/methodologies/{id}.methodology.yaml
+2. Built-in: methodologies/{id}.methodology.yaml
+3. Fallback: Generic phase-less workflow
+```
+
+---
+
+## Checklist 管理
+
+### 显示格式
+
+```markdown
+### Phase Checklist
+
+**Required:**
+- [ ] Test describes expected behavior
+- [x] Test name is clear
+- [ ] Test follows AAA pattern
+
+**Optional:**
+- [ ] Consider edge cases
+```
+
+### 跟踪
+
+- 根据用户动作与代码分析更新 checklist 项目
+- 若 required 项目未完成则阻挡 phase 转换（strict mode）
+- 记录完成状态以供审计轨迹使用
+
+---
+
+## 集成点
+
+### 与 Git 集成
+
+- 检测 commit 以重置 phase 计时器
+- 根据 methodology 建议 commit message
+- 自动纳入 spec/story 引用
+
+### 与 Test Runner 集成
+
+- 检测 test 通过/失败以触发 phase 转换
+- 报告与当前 phase 相关的 test 覆盖率
+
+### 与 Code Review 集成
+
+- 加入 methodology 专属的 review 检查
+- 在 PR 描述中引用启用中的 methodology
+
+---
+
+## 错误处理
+
+### 找不到 Methodology
+
+```
+⚠️ Methodology 'custom-workflow' not found.
+
+Available methodologies:
+- tdd (built-in)
+- bdd (built-in)
+- sdd (built-in)
+- atdd (built-in)
+
+Use `/methodology list` to see all options.
+```
+
+### 无效的 Phase 转换
+
+```
+⚠️ Cannot transition from RED to REFACTOR.
+
+TDD requires: RED → GREEN → REFACTOR
+
+Current phase: RED
+Valid next phases: GREEN
+
+Complete the RED phase checklist first.
+```
+
+---
+
+## 性能考量
+
+- 首次加载后缓存 methodology 定义
+- 仅在 manifest 变更时才重新加载
+- 最小化 checkpoint 频率以避免打断
+- 批量执行 git status 检查
+
+---
+
+## 本地化（Localization）
+
+所有面向用户的文字都应使用适当的语言字段：
+
+```yaml
+# If user's locale is zh-TW
+name: nameZh || name
+description: descriptionZh || description
+prompt: promptZh || prompt
+```
+
+---
+
+## 6. Prerequisite 检查 / Prerequisite Checking
+
+在执行任何 slash 命令之前，请遵循定义于
+[`prerequisite-check.md`](../../../../skills/dev-methodology/prerequisite-check.md) 的 prerequisite 检查协议。
+
+**Priority**: 此检查会在 phase 跟踪与 methodology 检测之前执行。
+
+**与 Phase 跟踪的集成**：
+- 若用户处于启用中的 methodology session，使用该 methodology 的 phase
+  序列作为主要的 prerequisite 来源
+- 若无启用中的 methodology，使用 [`workflow-prerequisites.yaml`](../../../../methodologies/workflow-prerequisites.yaml) 作为 fallback
+- 若多个 workflow 都包含该命令，只需满足其中一个即可
+
+**Reference**: 完整的算法、evidence 检测规则及用户提示模板，请参阅 [`prerequisite-check.md`](../../../../skills/dev-methodology/prerequisite-check.md)。
+
+---
+
+## 版本历史
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.1.0 | 2026-02-12 | 新增 §6 Prerequisite Checking 集成 |
+| 1.0.0 | 2026-01-12 | Initial runtime specification |

package/bundled/locales/zh-CN/skills/dev-workflow-guide/SKILL.md

@@ -36,7 +36,7 @@ V. Release ──► VI. Documentation ──► VII. Standards ──► VIII.
 | **I. 规划与设计** | `/brainstorm` `/requirement` `/sdd` `/reverse` `/api-design` `/database` | 需求、规格、API/DB 设计 |
 | **II. 测试驱动开发** | `/bdd` `/atdd` `/tdd` `/coverage` `/derive` `/ac-coverage` | 先写测试再写代码 |
 | **III. 实现** | `/refactor` `/reverse` `/migrate` `/durable` | 撰写、改善与迁移代码 |
-| **IV. 品质关卡** | `/checkin` `/review` `/security` `/scan` `/incident` | 品质、安全、事故响应 |
+| **IV. 品质关卡** | `/checkin` `/code-review` `/security` `/scan` `/incident` | 品质、安全、事故响应 |
 | **V. 发布与提交** | `/commit` `/changelog` `/release` `/pr` `/ci-cd` | 版本、提交、PR、CI/CD |
 | **VI. 文档** | `/docs` `/docgen` | 文档与项目结构 |
 | **VII. 工具与标准** | `/discover` `/guide` `/metrics` `/audit` | 参考指南、指标、审计 |
@@ -164,7 +164,7 @@ V. Release ──► VI. Documentation ──► VII. Standards ──► VIII.
 2. **阶段参数**：显示该阶段的详细指引，包含所有相关命令与示例
 3. **场景参数**：显示该场景的推荐逐步工作流程
 
-此技能会从 [workflow-phases.md](./workflow-phases.md) 读取详细的阶段信息。
+此技能会从 [workflow-phases.md](../../../../skills/dev-workflow-guide/workflow-phases.md) 读取详细的阶段信息。
 
 ## 下一步引导
 
@@ -181,10 +181,10 @@ V. Release ──► VI. Documentation ──► VII. Standards ──► VIII.
 
 ## 参考
 
-- [详细阶段指南](./workflow-phases.md) - 完整的逐阶段参考
+- [详细阶段指南](../../../../skills/dev-workflow-guide/workflow-phases.md) - 完整的逐阶段参考
 - [日常工作流程指南](../../../../adoption/DAILY-WORKFLOW-GUIDE.md) - 综合日常工作流程指南
-- [功能开发工作流程](../workflows/feature-dev.yaml) - 自动化功能开发工作流程
-- [集成流程工作流程](../workflows/integrated-flow.yaml) - 完整的 ATDD/SDD/BDD/TDD 工作流程
+- [功能开发工作流程](../../../../skills/workflows/feature-dev.workflow.yaml) - 自动化功能开发工作流程
+- [集成流程工作流程](../../../../skills/workflows/integrated-flow.workflow.yaml) - 完整的 ATDD/SDD/BDD/TDD 工作流程
 
 ---
 

package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md

@@ -80,7 +80,7 @@ language: [en, zh-TW]
 > **文档已生成。建议下一步：**
 > - 审查生成的文档内容是否完整
 > - 执行 `/commit` 提交文档变更
-> - 执行 `/review` 审查文档品质
+> - 执行 `/code-review` 审查文档品质
 
 ## 参考
 

package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md

@@ -81,4 +81,4 @@ description: "[UDS] 从 BDD 场景生成 E2E 测试骨架，支持框架检测
 
 ## AI 代理行为
 
-> 完整的 AI 行为定义请参阅对应的命令文件：[`/e2e`](../../commands/e2e.md#ai-agent-behavior--ai-代理行为)
+> 完整的 AI 行为定义请参阅对应的命令文件：[`/e2e`](../../../../skills/commands/e2e.md#ai-agent-behavior--ai-代理行為)

package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md

@@ -141,7 +141,7 @@ docs/incidents/
 
 > **事故回应指引已提供。建议下一步：**
 > - 执行 `/commit` 创建修复提交 ⭐ **推荐**
-> - 执行 `/review` 审查修复变更
+> - 执行 `/code-review` 审查修复变更
 > - 执行 `/docs` 更新文档
 > - 执行 `/security` 检查安全影响
 > - 执行 `/retrospective`（SEV-1/SEV-2 建议）— 团队回顾
@@ -150,4 +150,4 @@ docs/incidents/
 ## 参考
 
 - 核心规范：[deployment-standards.md](../../../../core/deployment-standards.md)
-- 核心规范：[logging.md](../../../../core/logging.md)
+- 核心规范：[logging.md](../../../../core/logging-standards.md)

package/bundled/locales/zh-CN/skills/journey-test-assistant/SKILL.md

@@ -204,6 +204,6 @@ describe.skipIf(!BASE_URL)("Platform Admin Journey — T-001 → T-010", () => {
 
 ## 参考
 
-- 标准：[user-journey-testing.ai.yaml](../../.standards/user-journey-testing.ai.yaml)
+- 标准：[user-journey-testing.ai.yaml](../../../../.standards/user-journey-testing.ai.yaml)
 - 相关 XSPEC：XSPEC-128（UDS 标准定义）
 - 相关 Skill：`/e2e`（AC 层测试）、`/atdd`（验收条件定义）