Menu
[UDS] 設計 AI 友善架構，包含明確模式、分層文件和語義邊界
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/AsiaOstrich/universal-dev-standards --skill ai-friendly-architectureThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Based on SOC occupation classification
Showing SKILL.md
| name | ai-friendly-architecture |
| source | ../../../../skills/ai-friendly-architecture/SKILL.md |
| source_version | 1.0.0 |
| translation_version | 1.0.0 |
| last_synced | "2026-02-05T00:00:00.000Z" |
| status | current |
| scope | universal |
| description | [UDS] 設計 AI 友善架構，包含明確模式、分層文件和語義邊界 |
語言: English | 繁體中文
版本: 1.0.0 最後更新: 2026-01-25 適用範圍: Claude Code Skills
核心標準: 本技能實作 AI 友善架構。完整方法論文件請參閱核心標準。
本技能協助設計專案架構，透過明確模式、分層文件和語義邊界，最大化 AI 協作效能。
| 原則 | 描述 | 效益 |
|---|---|---|
| 明確優於隱含 | 明確記錄行為 | AI 無需猜測即可理解 |
| 分層上下文 | 多層級文件 | 依任務提供適當細節 |
| 語義邊界 | 清晰的模組邊界 | 獨立分析 |
| 可發現結構 | 自我說明的結構 | 快速定位 |
| 層級 | Token 預算 | 內容 |
|---|---|---|
| L1: 快速參考 | < 500 | 單行說明、API 簽章、入口點 |
| L2: 詳細 | < 5,000 | 完整 API 文件、使用範例 |
| L3: 範例 | 無限制 | 完整實作、邊界案例 |
project/
├── .ai-context.yaml # AI 上下文配置
├── docs/
│ ├── QUICK-REF.md # 第 1 層文件
│ └── ARCHITECTURE.md # 第 2 層文件
├── src/
│ └── auth/
│ ├── index.ts # 入口點與模組標頭
│ ├── QUICK-REF.md # 模組快速參考
│ └── README.md # 模組文件
└── CLAUDE.md # AI 指令檔案
/**
* ═══════════════════════════════════════════════════════════
* 模組: [模組名稱]
* ═══════════════════════════════════════════════════════════
*
* 目的: [單句描述]
*
* 相依性:
* - [dep1]: [原因]
* - [dep2]: [原因]
*
* 匯出:
* - [function1](params): [描述]
* - [function2](params): [描述]
*
* 配置:
* - [CONFIG_VAR]: [描述]
*
* ═══════════════════════════════════════════════════════════
*/
完整標準請參閱：
AI 助手可使用 YAML 格式檔案以減少 Token 使用：
ai/standards/ai-friendly-architecture.ai.yaml# .ai-context.yaml - AI 上下文配置
version: 1.0.0
project:
name: my-project
type: web-app # web-app | library | cli | api | monorepo
primary-language: typescript
modules:
- name: auth
path: src/auth/
entry: index.ts
description: 驗證與授權
dependencies: [database, crypto]
priority: high
- name: api
path: src/api/
entry: routes.ts
description: REST API 端點
dependencies: [auth, database]
priority: high
analysis-hints:
entry-points:
- src/main.ts
- src/index.ts
ignore-patterns:
- node_modules
- dist
- "*.test.ts"
| 優先級 | 內容類型 | 原因 |
|---|---|---|
| 1 | 入口點 | 應用程式結構 |
| 2 | .ai-context.yaml | 模組地圖和相依性 |
| 3 | QUICK-REF 檔案 | 快速 API 理解 |
| 4 | 修改的檔案 | 與任務直接相關 |
| 5 | 相依鏈 | 變更的上下文 |
| 反模式 | 問題 | 解決方案 |
|---|---|---|
| 魔術字串 | AI 無法追蹤常數 | 帶文件的型別常數 |
| 隱式路由 | 隱藏行為 | 明確路由映射 |
| 全域狀態 | 不可預測的相依性 | 依賴注入 |
| 循環相依 | 上下文混亂 | 階層式相依 |
| 單體檔案 | 上下文溢出 | 專注的模組 |
.ai-context.yaml 含模組清單QUICK-REF.md.ai-context.yaml 配置QUICK-REF.md本技能支援專案特定配置。
.ai-context.yamlQUICK-REF.md 檔案若未找到配置：
.ai-context.yaml 範本QUICK-REF.md| 版本 | 日期 | 變更 |
|---|---|---|
| 1.0.0 | 2026-01-25 | 初始發布 |
本技能以 CC BY 4.0 授權發布。
After /ai-friendly-architecture completes, the AI assistant should suggest:
AI 友善架構指南已掌握。建議下一步 / AI-friendly architecture guide understood. Suggested next steps:
- 執行
/sdd將 AI 友善架構設計納入正式規格 ⭐ Recommended / 推薦 — 確保架構決策有規格追蹤 / Ensure architecture decisions are tracked in specs- 建立
.ai-context.yaml和QUICK-REF.md— 立即實作 AI 友善結構 / Implement AI-friendly structure immediately- 執行
/ai-instruction-standards更新 CLAUDE.md 以反映架構配置 — 讓 AI 指令檔案與架構保持同步 / Keep AI instruction files in sync with architecture
| Version | Date | Changes |
|---|---|---|
| 1.0.0 | 2026-01-25 | Initial release |
This skill is released under CC BY 4.0.
Source: universal-dev-standards
[UDS] 以 Claude 原生 Agent tool 编排多任务执行计划（DAG-based，无外部引擎）。 Use when: executing a plan.json file with parallel/sequential task dependencies. Keywords: orchestrate, plan, execute, DAG, task plan, 编排, 执行计划, 并行.
[UDS] 从 Spec 文档、OpenSpec 变更或自由文本需求生成 plan.json。 Use when: converting specifications into executable task plans for /orchestrate. Keywords: plan, spec, task plan, 计划, 规格, 任务, plan.json, DAG.
[UDS] AI 辅助 git push 安全层：质量门禁 + 协作护栏。 Use when: pushing commits, force pushing, pushing to protected branches, pushing feature branches. Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保护分支, 质量门禁.