universal-dev-standards 5.16.0 → 6.0.0

package/bundled/locales/zh-CN/skills/README.md

@@ -1,187 +1,150 @@
 ---
 source: ../../../skills/README.md
 source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-01-07
+translation_version: 1.2.0
+last_synced: 2026-06-20
 status: current
 ---
 
-# Claude Code Skills
+# 通用开发 Skills
 
 > **语言**: [English](../../../skills/README.md) | 简体中文
 
-软体开发标准的 Claude Code Skills。
+本目录收录通用开发标准（UDS）skill 的参考实现。这些 skill 尽可能设计为与工具无关，作为 AI 编程助手的「真实来源（Source of Truth）」。
 
 > 衍生自 [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards) 核心标准。
 
-## 概述
+> **完整的索引式 skill 列表**（按 Tier、分类与使用场景）请见 **[docs/user/SKILLS-INDEX.md](../../../docs/user/SKILLS-INDEX.md)**（自动生成）。
+> 斜线命令参考请见 **[docs/user/COMMANDS-INDEX.md](../../../docs/user/COMMANDS-INDEX.md)**。
 
-这些技能会根据上下文在使用 Claude Code 时自动觸發，協助您：
+## 目录结构
 
-- 透過基於证据的响应防止 AI 幻覺
-- 撰写一致且格式良好的提交消息
-- 进行全面的程序码审查
-- 遵循测试最佳实踐
-- 使用語意化版本管理發布
+```
+skills/
+├── commands/          # 通用斜线命令定义（.md）
+├── agents/            # 通用 Agent 定义（.md）
+├── workflows/         # 通用 Workflow 定义（.yaml）
+├── tools/             # 工具专属的 adapter 与配置
+│   ├── cline/         # Cline (.clinerules)
+│   ├── cursor/        # Cursor (.cursorrules)
+│   ├── windsurf/      # Windsurf (.windsurfrules)
+│   └── copilot/       # GitHub Copilot (instructions.md)
+├── _shared/           # 共用模板与工具
+└── [skill-name]/      # 单个 skill 定义（例如 git-workflow-guide/）
+```
+
+## 通用 Skills 与命令
 
-## 可用的 Skills
+这些 skill 提供标准指引与工作流。在支持的工具中（如 Claude Code、OpenCode）可通过斜线命令访问，也可手动引用。
 
 | Skill（文件夹） | 命令 | 描述 |
 |----------------|---------|-------------|
 | `guide` | `/guide` | [UDS] 访问所有标准指南 |
-| `checkin-assistant` | `/checkin` | [UDS] 提交前质量闸门 |
+| `checkin-assistant` | `/checkin` | [UDS] 提交前质量门禁 |
 | `commit-standards` | `/commit` | [UDS] Conventional Commits 格式 |
-| `code-review-assistant` | `/review` | [UDS] 系统化程序码审查 |
+| `code-review-assistant` | `/code-review` | [UDS] 系统化代码审查 |
 | `tdd-assistant` | `/tdd` | [UDS] 测试驱动开发 |
 | `bdd-assistant` | `/bdd` | [UDS] 行为驱动开发 |
 | `atdd-assistant` | `/atdd` | [UDS] 验收测试驱动开发 |
 | `e2e-assistant` | `/e2e` | [UDS] 从 BDD 场景生成 E2E 测试骨架 |
-| `release-standards` | `/release` | [UDS] 发布与变更日志管理 |
+| `journey-test-assistant` | `/journey-test` | [UDS] 连贯用户旅程测试计划（TESTPLAN）＋ E2E 骨架生成 |
+| `release-standards` | `/release` | [UDS] 发行与 Changelog 管理 |
 | `documentation-guide` | `/docs` | [UDS] 文档管理 |
 | `requirement-assistant` | `/requirement` | [UDS] 需求撰写 |
-| `reverse-engineer` | `/reverse` | [UDS] 逆向工程程序码 |
-| `forward-derivation` | `/derive` | [UDS] 从规格衍生产出物 |
+| `reverse-engineer` | `/reverse` | [UDS] 逆向工程代码 |
+| `spec-derivation` | `/derive` | [UDS] 从 spec 推导 BDD/TDD/ATDD 产物 |
 | `spec-driven-dev` | `/sdd` | [UDS] 规格驱动开发 |
 | `test-coverage-assistant` | `/coverage` | [UDS] 测试覆盖率分析 |
-| `methodology-system` | `/methodology` | [UDS] 开发方法论 |
+| `dev-methodology` | `/methodology` | [UDS] 开发方法论 |
 | `refactoring-assistant` | `/refactor` | [UDS] 重构指引 |
 | `project-discovery` | `/discover` | [UDS] 评估项目健康度与风险 |
-| `brainstorm-assistant` | `/brainstorm` | [UDS] 结构化 AI 辅助构想 |
-| `changelog-guide` | `/changelog` | [UDS] 生成变更日志条目 |
+| `brainstorm-assistant` | `/brainstorm` | [UDS] 结构化 AI 辅助构思 |
+| `changelog-guide` | `/changelog` | [UDS] 生成 changelog 条目 |
 | `dev-workflow-guide` | `/dev-workflow` | [UDS] 将开发阶段对应到 UDS 命令 |
 | `docs-generator` | `/docgen` | [UDS] 生成使用文档 |
+| `security-assistant` | `/security` | [UDS] 安全审查与漏洞评估 |
+| `security-scan-assistant` | `/scan` | [UDS] 自动化安全扫描与依赖审计 |
+| `api-design-assistant` | `/api-design` | [UDS] API 设计（REST、GraphQL、gRPC）|
+| `database-assistant` | `/database` | [UDS] 数据库设计、迁移、查询优化 |
+| `ci-cd-assistant` | `/ci-cd` | [UDS] CI/CD 管线设计与优化 |
+| `incident-response-assistant` | `/incident` | [UDS] 事故响应与事后复盘 |
+| `pr-automation-assistant` | `/pr` | [UDS] Pull request 创建与审查自动化 |
+| `metrics-dashboard-assistant` | `/metrics` | [UDS] 开发指标与项目健康度 |
+| `durable-execution-assistant` | `/durable` | [UDS] 工作流故障恢复与回滚 |
+| `migration-assistant` | `/migrate` | [UDS] 代码迁移与框架升级 |
+| `audit-assistant` | `/audit` | [UDS] 标准合规审计 |
+| `observability-assistant` | `/observability` | [UDS] 可观测性配置、指标、告警 🆕 |
+| `slo-assistant` | `/slo` | [UDS] SLI 选择、SLO 设定、Error Budget 🆕 |
+| `runbook-assistant` | `/runbook` | [UDS] Runbook 创建、演练、覆盖率 🆕 |
+| `skill-builder` | `/skill-builder` | [UDS] 识别重复流程并以正确的开发深度构建 Skill |
+
+> **注意**：参考型指南（如 Git Workflow、Logging、Error Codes）请使用 `/guide` 命令。
+
+## Skill Tier（列出预算优化）
+
+> 背景：Claude Code 通过 `skillListingBudgetFraction` 保留一小部分 context（默认 1%）用于列出 skill。当有 40+ 个 UDS skill 加上采用者安装的 plugin 时，描述可能被截断。UDS 将 skill 组织为三个 tier，让采用者可选择性抑制较少用的描述，同时保持 skill 仍可通过 `/<name>` 调用。
+>
+> 决策与权衡见 [DEC-061](https://github.com/AsiaOstrich/dev-platform/blob/main/cross-project/decisions/DEC-061-uds-skill-listing-budget.md)。参考配置位于 [`examples/skill-overrides-recommended.json`](../../../examples/skill-overrides-recommended.json)。详细调整：[`docs/skill-budget-tuning.md`](../../../docs/skill-budget-tuning.md)。
 
-## 静态与动态规范
-
-规范依据应用时机分为兩类：
-
-Standards are classified into two types based on when they should be applied:
-
-### 静态规范（项目文件）
-
-这些规范应該**隨时生效**，建议放在项目的 `CLAUDE.md` 或 `.cursorrules` 中：
-
-These standards should **always be active**. Add them to your project's `CLAUDE.md` or `.cursorrules`:
-
-| Standard | 核心規則 | Key Rules |
-|----------|---------|-----------|
-| [anti-hallucination](../../../core/anti-hallucination.md) | 确定性标签、建议原則 | Certainty labels, suggestion principles |
-| [checkin-standards](../../../core/checkin-standards.md) | 编譯通過、测试通過、覆蓋率达標 | Build passes, tests pass, coverage met |
-| [project-structure](../../../core/project-structure.md) | 目录结构规范 | Directory structure conventions |
+### Tier 1 — Core（每日使用）
+**列出默认**：`"on"`（显示完整描述）。永远可自动发现。
 
-> 📄 參見 [CLAUDE.md.template](../../../templates/CLAUDE.md.template) 取得可直接使用的範本。
->
-> 📄 See [CLAUDE.md.template](../../../templates/CLAUDE.md.template) for a ready-to-use template.
+`commit-standards`、`push`、`git-workflow-guide`、`tdd-assistant`、`bdd-assistant`、`testing-guide`、`code-review-assistant`、`refactoring-assistant`、`requirement-assistant`、`spec-driven-dev`、`adr-assistant`、`dev-workflow-guide`、`checkin-assistant`
 
-### 动态规范（Skills）
+### Tier 2 — Advanced（每周使用）
+**列出默认**：`"on"`（显示完整描述）。
 
-这些规范由**关鍵字觸發**，按需载入。安裝为 Skills 使用：
+`atdd-assistant`、`e2e-assistant`、`journey-test-assistant`、`contract-test-assistant`、`security-assistant`、`deploy-assistant`、`ci-cd-assistant`、`error-code-guide`、`logging-guide`、`documentation-guide`、`api-design-assistant`、`database-assistant`、`project-structure-guide`、`ai-instruction-standards`、`release-standards`、`changelog-guide`、`test-coverage-assistant`、`pr-automation-assistant`、`spec-derivation`、`reverse-engineer`、`project-discovery`、`dev-methodology`、`audit-assistant`、`docs-generator`
 
-These are **triggered by keywords** or specific tasks. Install as Skills:
+### Tier 3 — Specialist（每月或事件驱动）
+**列出默认**：在参考覆写中为 `"name-only"`——节省 token；**仍可通过 `/<name>` 调用**。
 
-| Skill | 觸發关鍵字 | Trigger Keywords |
-|-------|-----------|-----------------|
-| commit-standards | 提交、消息 | commit, git, message |
-| code-review-assistant | 审查、检查 | review, PR, checklist |
-| git-workflow-guide | 分支、合併 | branch, merge, workflow |
-| testing-guide | 测试、覆蓋率 | test, coverage, pyramid |
-| tdd-assistant | TDD、测试優先、紅綠重構 | TDD, test first, red green refactor |
-| release-standards | 版本、發布 | version, release, semver |
-| documentation-guide | 文件、文档 | README, docs, documentation |
-| requirement-assistant | 規格、需求、新功能 | spec, SDD, requirement |
+`incident-response-assistant`、`observability-assistant`、`slo-assistant`、`runbook-assistant`、`retrospective-assistant`、`durable-execution-assistant`、`metrics-dashboard-assistant`、`migration-assistant`、`security-scan-assistant`、`brainstorm-assistant`、`skill-builder`
 
-> 📖 參見[静态与动态指南](../../../adoption/STATIC-DYNAMIC-GUIDE.md)了解详细分类说明。
->
-> 📖 See [Static vs Dynamic Guide](../../../adoption/STATIC-DYNAMIC-GUIDE.md) for detailed classification.
+> Tier 的理由与准则：[`flows/skill-tiering-rationale.md`](../../../flows/skill-tiering-rationale.md)。采用者可自由覆写参考配置（若每日使用某个 Tier 3 skill 可升为 `"on"`，或将任一 skill 降为 `"name-only"`）。
 
-## 安裝
+## Tool Adapters
 
-### 推荐：Plugin Marketplace
+各种 AI 工具的专属配置位于 `skills/tools/`。
 
-透過 Claude Code Plugin Marketplace 安裝以獲得自动更新：
+### Claude Code / OpenCode
+`skills/` 根目录下的文件（commands、agents、workflows）可直接兼容于 Claude Code 与 OpenCode。
 
+**安装（Plugin Marketplace）：**
 ```bash
-# 新增 marketplace（一次性设置）
 /plugin marketplace add AsiaOstrich/universal-dev-standards
-
-# 安裝包含所有 15 个技能的插件
 /plugin install universal-dev-standards@asia-ostrich
 ```
 
-**優点：**
-- ✅ Claude Code 重啟时自动更新
-- ✅ 与 Claude Code 更好的集成
-- ✅ 無需手动維護
-
-所有技能將自动载入并可使用。
-
-### 替代方案：脚本安裝（已棄用）
-
-> ⚠️ **已棄用**：透過脚本手动安裝已棄用，將在未來版本中移除。請改用 Plugin Marketplace。
-
-适用于无法访问 Marketplace 的环境（例如企业网络）：
-
-#### 手动安装（选择性 Skills）
-
-**macOS / Linux:**
+### Cursor
+位于 `skills/tools/cursor/`。
 ```bash
-mkdir -p ~/.claude/skills
-cp -r ai-collaboration-standards ~/.claude/skills/
-cp -r commit-standards ~/.claude/skills/
+cp skills/tools/cursor/.cursorrules .cursorrules
 ```
 
-**Windows PowerShell:**
-```powershell
-New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.claude\skills
-Copy-Item -Recurse ai-collaboration-standards $env:USERPROFILE\.claude\skills\
-Copy-Item -Recurse commit-standards $env:USERPROFILE\.claude\skills\
-```
-
-### 替代方案：项目层级安裝（已棄用）
-
-> ⚠️ **已棄用**：项目层级手动安裝已棄用。建议使用 Plugin Marketplace 以獲得最佳体驗。
-
-適用於项目特定技能自订：
-
-**macOS / Linux:**
+### Windsurf
+位于 `skills/tools/windsurf/`。
 ```bash
-mkdir -p .claude/skills
-cp -r /path/to/skills/* .claude/skills/
+cp skills/tools/windsurf/.windsurfrules .windsurfrules
 ```
 
-**Windows PowerShell:**
-```powershell
-New-Item -ItemType Directory -Force -Path .claude\skills
-Copy-Item -Recurse path\to\skills\claude-code\* .claude\skills\
+### Cline
+位于 `skills/tools/cline/`。
+```bash
+cp skills/tools/cline/.clinerules .clinerules
 ```
 
-> **注意**：项目层级技能（`.claude/skills/`）優先於全域技能（`~/.claude/skills/`）。
-
-## 设置
-
-Skills 支援透過 `CONTRIBUTING.md` 进行项目特定设置。
-
-### 停用 Skills
-
-在您的项目 `CONTRIBUTING.md` 中加入：
-
-```markdown
-## Disabled Skills
-
-- testing-guide
-- release-standards
+### GitHub Copilot
+位于 `skills/tools/copilot/`。
+```bash
+mkdir -p .github
+cp skills/tools/copilot/copilot-instructions.md .github/copilot-instructions.md
 ```
 
-### 设置範本
-
-完整设置选项請參見 [CONTRIBUTING.template.md](../../../skills/CONTRIBUTING.template.md)。
-
-## Skill 優先順序
+## 贡献
 
-當同一个 skill 同时存在於兩个位置时：
-1. **项目层级**（`.claude/skills/`）優先
-2. **全域层级**（`~/.claude/skills/`）为备援
+新增 skill 或支持更多 AI 工具的指引，请见 [CONTRIBUTING.template.md](CONTRIBUTING.template.md)。
 
-## 授权条款
+## 许可
 
-雙重授权：CC BY 4.0（文件）+ MIT（程序码）
+双重许可：CC BY 4.0（文档）＋ MIT（代码）

package/bundled/locales/zh-CN/skills/ac-coverage/SKILL.md

@@ -38,13 +38,12 @@ argument-hint: "[规格文件路径]"
 
 ## 链接标注约定
 
-测试**必须**使用标准标注引用其来源 AC：
+测试**必须**使用 **canonical 合并标注** `@SPEC-<id> @AC-<n>`（单一合并标签、保持同一行；**勿**拆成 `@AC` / `@SPEC` 两行）引用其来源 AC：
 
 ```typescript
 // TypeScript/JavaScript
 describe('AC-1: User login with valid credentials', () => {
-  // @AC AC-1
-  // @SPEC SPEC-001
+  // @SPEC-001 @AC-1
   it('should redirect to dashboard on successful login', () => { ... });
 });
 ```
@@ -53,8 +52,7 @@ describe('AC-1: User login with valid credentials', () => {
 # Python
 class TestAC1_UserLogin:
     """AC-1: User login with valid credentials
-    @AC AC-1
-    @SPEC SPEC-001
+    @SPEC-001 @AC-1
     """
     def test_redirect_to_dashboard(self): ...
 ```
@@ -85,7 +83,7 @@ Scenario: User login with valid credentials
 Layer 0：需求 / 用户故事 (REQ)
     ↓ （定义）
 Layer 1：验收条件 (AC)
-    ↓ （@AC 标注）
+    ↓ （@SPEC-NNN @AC-N 标注）
 Layer 2：测试用例
     ↓ （覆盖）
 Layer 3：源代码 (@implements)
@@ -191,4 +189,4 @@ function authenticate(user: string, pass: string) { ... }
 
 ## AI 代理行为
 
-> 完整的 AI 行为定义请参阅对应的命令文件：[`/ac-coverage`](../../../../skills/commands/ac-coverage.md#ai-agent-behavior--ai-代理行为)
+> 完整的 AI 行为定义请参阅对应的命令文件：[`/ac-coverage`](../../../../skills/commands/ac-coverage.md#ai-agent-behavior--ai-代理行為)

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

@@ -127,7 +127,7 @@ docs/adr/
 | 技能 | 集成方式 |
 |------|---------|
 | `/sdd` | 在技术设计中引用 ADR；重大决策时建议创建 ADR |
-| `/review` | 代码审查时引用 ADR 作为设计依据 |
+| `/code-review` | 代码审查时引用 ADR 作为设计依据 |
 | `/commit` | 提交时在 footer 加入 ADR 编号 |
 | `/brainstorm` | 头脑风暴结果作为 ADR 选项分析输入 |
 

package/bundled/locales/zh-CN/skills/agents/code-architect.md

@@ -0,0 +1,263 @@
+---
+name: code-architect
+version: 1.1.0
+source: skills/agents/code-architect.md
+source_version: 1.1.0
+translation_version: 1.0.0
+status: current
+description: |
+  系统设计与技术规划的 software architecture 专家。
+  使用时机：设计系统、规划架构、评估 pattern、撰写技术提案时。
+  Keywords: architecture, system design, design patterns, technical design, API design, database modeling, 架构, 系统设计, 技术设计.
+
+role: specialist
+expertise:
+  - system-design
+  - api-design
+  - database-modeling
+  - design-patterns
+  - scalability
+  - microservices
+
+allowed-tools:
+  - Read
+  - Glob
+  - Grep
+  - Bash(git:*)
+  - WebFetch
+  - WebSearch
+disallowed-tools:
+  - Write
+  - Edit
+
+skills:
+  - spec-driven-dev
+  - project-structure-guide
+
+model: claude-sonnet-4-20250514
+temperature: 0.3
+
+# === CONTEXT STRATEGY (RLM-inspired) ===
+# Architecture analysis requires understanding overall structure before drilling into details
+context-strategy:
+  mode: adaptive
+  max-chunk-size: 50000
+  overlap: 500
+  analysis-pattern: hierarchical
+
+triggers:
+  keywords:
+    - architecture
+    - system design
+    - design pattern
+    - scalability
+    - API design
+    - database schema
+    - 架构设计
+    - 系统设计
+  commands:
+    - /architect
+---
+
+# Code Architect Agent
+
+> **语言**: [English](../../../../skills/agents/code-architect.md) | 简体中文
+
+## 目的
+
+Code Architect agent 专精于 software architecture 与 system design。它会分析代码库、评估 design pattern，并提供技术建议，以打造可扩展且易于维护的系统。
+
+## 能力
+
+### 我能做的事
+
+- 分析既有代码库的 architecture
+- 针对特定问题推荐 design pattern
+- 设计 API contract 与 data model
+- 评估 scalability 与性能影响
+- 建立 architecture decision record（ADR）
+- 审查技术提案
+
+### 我无法做的事
+
+- 直接编写或修改代码（只读）
+- 在缺乏 context 的情况下做出实现决策
+- 在未经 benchmark 的情况下保证性能
+
+## 工作流程
+
+```
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│   Understand    │───▶│    Analyze      │───▶│   Recommend     │
+│   Requirements  │    │    Codebase     │    │   Architecture  │
+└─────────────────┘    └─────────────────┘    └─────────────────┘
+                                                      │
+                                                      ▼
+                       ┌─────────────────┐    ┌─────────────────┐
+                       │    Document     │◀───│    Validate     │
+                       │    Decision     │    │    Trade-offs   │
+                       └─────────────────┘    └─────────────────┘
+```
+
+### 1. 理解需求
+
+- 收集功能性与非功能性需求
+- 识别约束（预算、时程、团队技能）
+- 厘清 scalability 与性能需求
+
+### 2. 分析代码库
+
+- 盘点既有 architecture 与组件
+- 识别当前使用的 pattern
+- 找出技术债所在区域
+
+### 3. 推荐架构
+
+- 提出 architectural pattern
+- 设计组件交互方式
+- 定义 data flow 与存储策略
+
+### 4. 验证权衡
+
+- 评估各方案的优缺点
+- 考量团队专业与维护负担
+- 评估风险与缓解策略
+
+### 5. 记录决策
+
+- 建立 Architecture Decision Record（ADR）
+- 记录理由与曾考量的替代方案
+- 定义成功指标
+
+## 分析框架
+
+### 架构评估准则
+
+| 准则 | 描述 | 权重 |
+|-----------|-------------|--------|
+| **Scalability** | 是否能应对增长？ | High |
+| **Maintainability** | 是否易于修改与扩展？ | High |
+| **Testability** | 是否易于独立测试？ | Medium |
+| **Performance** | 是否符合性能需求？ | Medium |
+| **Security** | 是否在设计上即安全？ | High |
+| **Simplicity** | 是否避免不必要的复杂度？ | Medium |
+
+### 我常推荐的 Pattern
+
+| Pattern | 使用场景 | 权衡 |
+|---------|----------|------------|
+| **Layered Architecture** | 传统应用、清晰分层 | 可能变得僵化 |
+| **Microservices** | 大型团队、独立扩展 | 运维复杂度高 |
+| **Event-Driven** | 异步处理、解耦 | 调试困难 |
+| **CQRS** | 读写优化 | 额外的复杂度成本 |
+| **Hexagonal** | 以 domain 为中心、易于测试 | 学习曲线 |
+
+## 输出格式
+
+### Architecture Decision Record（ADR）
+
+```markdown
+# ADR-001: [Decision Title]
+
+## Status
+Proposed | Accepted | Deprecated | Superseded
+
+## Context
+What is the issue that we're seeing that is motivating this decision?
+
+## Decision
+What is the change that we're proposing?
+
+## Consequences
+What becomes easier or more difficult because of this change?
+
+## Alternatives Considered
+What other options were evaluated?
+```
+
+### 组件图（Mermaid）
+
+```mermaid
+graph TD
+    A[Client] --> B[API Gateway]
+    B --> C[Auth Service]
+    B --> D[User Service]
+    B --> E[Order Service]
+    D --> F[(User DB)]
+    E --> G[(Order DB)]
+```
+
+## 准则
+
+### 应做事项
+
+- 在提出解决方案前，务必先理解问题
+- 考量团队的专业与约束
+- 明确记录权衡取舍
+- 从简单开始，仅在有正当理由时才增加复杂度
+- 在适用时参照既有代码库的 pattern
+
+### 不应做事项
+
+- 不要在缺乏正当理由下推荐 pattern
+- 不要忽略非功能性需求
+- 不要为假设性场景过度设计
+- 不要在未理解既有 architecture 为何存在前就否定它
+
+## 集成点
+
+### 与 Spec-Driven Development 集成
+
+Architecture 决策应记录为 spec：
+1. 建立 architecture 提案 spec
+2. 取得利益相关者审查
+3. 批准后实现
+
+### 与 Code Review 集成
+
+Architecture 变更应就以下方面进行审查：
+- 是否遵循已记录的 pattern
+- 是否与既有 architecture 一致
+- 是否妥善更新文档
+
+## 交互示例
+
+**用户**：为我们的 e-commerce 平台设计一套 authentication 系统。
+
+**Code Architect**：
+
+让我先分析你的需求与既有代码库。
+
+*[读取相关文件、分析 pattern]*
+
+根据我的分析，我建议：
+
+**Architecture**：OAuth 2.0 搭配 JWT token
+
+**Components**：
+1. Auth Service —— token 签发与验证
+2. User Service —— 用户个人资料管理
+3. Session Store —— 以 Redis 存放 refresh token
+
+**Trade-offs**：
+- 优点：stateless、可扩展、业界标准
+- 缺点：token 撤销需要额外的基础设施
+
+**ADR**：我会建立 ADR-001 来记录此决策。
+
+---
+
+## 版本历史
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.1.0 | 2026-01-21 | Added RLM-inspired context-strategy configuration |
+| 1.0.0 | 2026-01-20 | Initial release |
+
+---
+
+## 授权
+
+本 agent 以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。
+
+**来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)