Agent skill

Architecture Advisor

by ProgrammerAnthony in ProgrammerAnthony/Expert-Coding-Harness

A skill your agent uses when 用户需要设计新系统架构、评审或优化已有系统架构、选择技术方案时。触发场景:架构分析、架构设计、系统设计、architecture、架构优化、系统架构、架构评审、架构咨询、技术方案、技术设计、如何组织代码结构、模块划分、服务拆分、数据库选型、微服务设计。

MITAuto-check passedDevelopment

Install Architecture Advisor

skills CLI
$ npx skills add ProgrammerAnthony/Expert-Coding-Harness --skill architecture-advisor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ProgrammerAnthony/Expert-Coding-Harness architecture-advisor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ProgrammerAnthony/Expert-Coding-Harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/architecture-advisor .claude/skills/architecture-advisor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
architecture-advisor
GitHub stars
235
Token cost
~673 tokens
SKILL.md length
102 words
Files
5 (incl. references)
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when 用户需要设计新系统架构、评审或优化已有系统架构、选择技术方案时。触发场景:架构分析、架构设计、系统设计、architecture、架构优化、系统架构、架构评审、架构咨询、技术方案、技术设计、如何组织代码结构、模块划分、服务拆分、数据库选型、微服务设计。

  • Works in 5 steps: 分层架构详图(加载… → 核心模块定义(职责、接口、边界) → 数据流设计(关键业务场景的数据流向) → …
  • 用户需要设计新系统架构、评审或优化已有系统架构、选择技术方案时。触发场景:架构分析、架构设计、系统设计、architecture、架构优化、系统架构、架构评审、架构咨询、技术方案、技术设计、如何组织代码结构、模块划分、服务拆分、数据库选型、微服务设计
  • SKILL.md covers 模式识别, 工作流 A:全新系统设计, 工作流 B:现有架构分析与优化 and DDD 概念应用, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Architecture Advisor is an agent skill from ProgrammerAnthony/Expert-Coding-Harness. Use when 用户需要设计新系统架构、评审或优化已有系统架构、选择技术方案时。触发场景:架构分析、架构设计、系统设计、architecture、架构优化、系统架构、架构评审、架构咨询、技术方案、技术设计、如何组织代码结构、模块划分、服务拆分、数据库选型、微服务设计。

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `README.md`, `references/architecture-patterns.md` and `references/ddd-concepts.md`).

It sits in Development, covering Domain-driven design. The repository describes itself as: 生产级 AI Agent 技能集,辅助AI Harness应用于企业开发,覆盖代码审查、代码安全审计、TDD、需求工程、实施计划与子代理编排、架构设计、调试、前端开发与技能创建全流程。 The licence is MIT.

When your agent uses it

  • 用户需要设计新系统架构、评审或优化已有系统架构、选择技术方案时。触发场景:架构分析、架构设计、系统设计、architecture、架构优化、系统架构、架构评审、架构咨询、技术方案、技术设计、如何组织代码结构、模块划分、服务拆分、数据库选型、微服务设计
  • Tasks that involve Domain-driven design

Example prompts

  • “/architecture-advisor”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 分层架构详图(加载 references/architecture-patterns.md)
  2. 核心模块定义(职责、接口、边界)
  3. 数据流设计(关键业务场景的数据流向)
  4. 关键技术决策(加载讨论,不直接拍板)
  5. 演进路径(从 MVP 到目标架构的分阶段路线图)

What it can do on your machine

Read from SKILL.md and the folder at commit ab0b827. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown, bash and mermaid).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Architecture Advisor loads about 673 tokens when it runs, and up to ~3.6k if it reads all its reference files. Until then it costs about 39 tokens; SKILL.md has 102 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~673
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ProgrammerAnthony/Expert-Coding-Harness at commit ab0b827, republished under its MIT licence (© ProgrammerAnthony). 102 words, ~673 tokens.

Download SKILL.mdSave it as .claude/skills/architecture-advisor/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
architecture-advisor
description
Use when 用户需要设计新系统架构、评审或优化已有系统架构、选择技术方案时。触发场景:架构分析、架构设计、系统设计、architecture、架构优化、系统架构、架构评审、架构咨询、技术方案、技术设计、如何组织代码结构、模块划分、服务拆分、数据库选型、微服务设计。

架构顾问

铁律:先通过提问充分理解需求和约束,再给出架构建议。不在信息不足时草率推荐方案。

模式识别

启动时识别用户场景:

你的需求是:
1. 全新系统设计 — 从零开始设计架构
2. 现有架构分析 — 对已有系统进行评审和优化

工作流 A:全新系统设计

阶段一:需求澄清(设计前禁止输出方案)

按优先级逐步询问(每次最多 2-3 个问题):

必问:

  • "这个系统的核心业务能力是什么(一句话描述)?"
  • "预期规模:DAU、QPS、数据量级是什么量级?"
  • "团队规模和技术栈偏好?(影响选型)"

按需追问:

  • "可用性要求:允许多长时间的停机?"
  • "数据一致性要求:是否可以接受最终一致性?"
  • "有没有已确定的外部依赖或集成点?"
  • "安全和合规要求?(金融、医疗等领域有特殊约束)"
阶段二:方案设计

基于需求信息,给出 2-3 个架构方案(不超过 3 个),每个方案包含:

markdown
### 方案 X:[方案名称]

**核心思路**:[一段话描述]

**架构图**:
[Mermaid 图]

**优点**:
- [针对需求的具体优点]

**缺点/权衡**:
- [需要接受的代价]

**适用条件**:[什么情况下这个方案更合适]
**技术复杂度**:低/中/高
**团队学习成本**:低/中/高

分节展示,每个方案得到用户反馈后再继续。

阶段三:深化选定方案

用户选择方案后,深化设计:

  1. 分层架构详图(加载 references/architecture-patterns.md)
  2. 核心模块定义(职责、接口、边界)
  3. 数据流设计(关键业务场景的数据流向)
  4. 关键技术决策(加载讨论,不直接拍板)
  5. 演进路径(从 MVP 到目标架构的分阶段路线图)

工作流 B:现有架构分析与优化

阶段一:现状收集
bash
# 探索项目结构
ls -la
find . -name "*.py" -o -name "*.ts" -o -name "*.go" | head -50
# 查看主要入口
cat main.py / main.go / app.ts
# 依赖关系
cat requirements.txt / go.mod / package.json

同时询问用户:

  • "当前架构的主要痛点是什么?"
  • "有哪些已知的性能或可靠性问题?"
  • "有什么变更触发了这次架构评审?"
阶段二:架构图还原

根据代码库结构,输出现有架构的 Mermaid 图:

mermaid
graph TD
    Client["客户端"] --> API["API 层"]
    API --> Service["服务层"]
    Service --> DB["数据库"]
    Service --> Cache["缓存"]
    Service --> MQ["消息队列"]

标注已识别的问题点(⚠️ 标记)。

阶段三:问题诊断

加载 references/architecture-patterns.md 对照检查:

  • 可扩展性:单点瓶颈、无法水平扩展的模块
  • 可靠性:单点故障、无容错机制
  • 可维护性:模块边界模糊、高耦合、循环依赖
  • 性能:同步阻塞、N+1 查询、缓存缺失
  • 安全性:认证授权缺陷、数据暴露风险
阶段四:优化路线图

加载 references/optimization-roadmap-template.md,输出:

markdown
## 优化路线图

### 立即行动(无需架构变更)
- [优化项 1]:[具体做法],预期收益 [X]

### 短期改进(1-3 个月)
- [改进项 1]:[描述变更范围],解决 [痛点 X]

### 中期重构(3-6 个月)
- [重构项 1]:[架构层面变更],需要 [资源 Y]

### 长期目标(6+ 个月)
- [目标架构]:[描述]

每项优化标注:影响面、实施成本、预期收益、风险。


DDD 概念应用

当系统复杂度较高时,加载 references/ddd-concepts.md 辅助边界设计:

  • 识别核心域、支撑域、通用域
  • 划分限界上下文(Bounded Context)
  • 定义聚合根和领域事件

警告:当你想跳过需求澄清时

遇到以下想法,立刻停下——没有充分信息的架构建议是有害的:

借口现实
"需求很明确,直接给方案就好"用户描述清晰 ≠ 约束条件明确。QPS、团队规模、合规要求都影响架构选型。
"微服务是最佳实践,直接推荐"微服务对小团队是负担。架构没有"最佳",只有"适合当前约束的"。
"只给一个方案更果断"一个方案 = 剥夺了用户了解权衡的机会。必须给 2-3 个选项。
"现有架构太乱,直接建议重写"重写是高风险决策。必须先出诊断报告,再出优化路线图,让用户决定。
"这个优化显然应该做""显然"的优化往往有隐藏成本。必须标注影响面、实施成本和风险。

参考资源

  • references/architecture-patterns.md — 常用架构模式与权衡
  • references/ddd-concepts.md — 领域驱动设计核心概念
  • references/optimization-roadmap-template.md — 优化路线图模板

© ProgrammerAnthony, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in skills/architecture-advisor of ProgrammerAnthony/Expert-Coding-Harness.

  • SKILL.md
  • README.md
  • references/architecture-patterns.md
  • references/ddd-concepts.md
  • references/optimization-roadmap-template.md

Open the folder on GitHubat commit ab0b827

Compare with similar skills

Architecture Advisor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Architecture Advisor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Architecture Advisor this skillProgrammerAnthony/Expert-Coding-Harness235—~673Automated safety check: PassMIT
Domain Modelingfossasia/eventyay-interpretation1.6k29 repos~821Automated safety check: PassApache-2.0
Architecture Governancezai-org/ZCode7.5k—~1.2kAutomated safety check: PassApache-2.0
Evolutionary Modular Architecturetech-leads-club/agent-skills7k—~3.7kAutomated safety check: PassCC-BY-4.0
Domain Modelingbrim-borium/spotify_sdk1665 repos~806Automated safety check: PassApache-2.0
Domain Modeling and Glossarywindmill-labs/windmill18k—~622Automated safety check: PassCustom licence

Similar skills

  • Domain Modeling

    fossasia/eventyay-interpretation

    Build and sharpen a project's domain model. An agent skill from fossasia/eventyay-interpretation.

    1.6k GitHub starsUsed in 29 repos~821 tokens
    DevelopmentAuto-check passed
  • Apply the repository's architecture policy to code changes by generating a bounded context package, checking module and layer boundaries, and reporting baseline-aware violations.

    7.5k GitHub stars~1.2k tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • Evolutionary Modular Architecture

    tech-leads-club/agent-skills

    Guides design of modular-monolith platforms with DDD, flat-by-aggregate modules, anti-corruption layers, outbox events and resilience, plus an architecture document with SVG diagrams.

    7k GitHub stars~3.7k tokensUpdated 17 days ago
    DevelopmentAuto-check passed
  • Domain Modeling

    brim-borium/spotify_sdk

    Build and sharpen a project's domain model. An agent skill from brim-borium/spotify_sdk.

    166 GitHub starsUsed in 5 repos~806 tokens
    DevelopmentAuto-check passed
  • Domain Modeling and Glossary

    windmill-labs/windmill

    Actively challenges vague or conflicting terminology as you design, and keeps a living domain glossary file up to date in real time.

    18k GitHub stars~622 tokensUpdated today
    DevelopmentAuto-check passed
  • Ddd

    swamp-club/swamp

    Domain Driven Design guidance for TypeScript/Deno codebases.

    642 GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed

More from ProgrammerAnthony/Expert-Coding-Harness

All 23 skills in this repo
  • Code Review Expert

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 用户要求审查代码、评估代码质量、提交 PR 前检查、发现代码有潜在问题时。触发场景:代码审查、code review、审查代码、review、检查代码、代码检查、代码质量、代码评审、这段代码有问题吗、帮我看看代码、合并前检查。

    235 GitHub stars~806 tokensUpdated 4 mo ago
    Auto-check passed
  • Code Security Audit

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 用户需要对代码进行安全审计、发现安全漏洞、上线前安全评估、检查代码是否存在安全风险时。触发场景:代码安全审计、安全审计、白盒审计、安全扫描、漏洞检测、漏洞挖掘、SQL注入、命令注入、XSS、SSRF、反序列化、认证绕过、越权、代码安全检查、security audit、code…

    235 GitHub stars~1.6k tokensUpdated 4 mo ago
    Auto-check passed
  • Debug Expert

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 程序出现错误、异常、崩溃,或行为与预期不符,或测试失败,或无法定位问题根因时。触发场景:调试、debug、报错、错误、异常、bug、问题排查、故障排查、不工作、崩溃、无法运行、出错了、为什么不生效、运行报错、跑不起来、程序挂了。

    235 GitHub stars~986 tokensUpdated 4 mo ago
    Auto-check passed
  • Frontend Code Review

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 用户需要审查前端代码(React/Vue/Next.js/TypeScript/Tailwind等)、检查代码质量、性能问题、可维护性、安全漏洞、最佳实践落地时。触发场景:前端代码评审、前端代码优化、React/Vue代码检查、TypeScript代码审查、前端性能优化、前端安全审计、前端代码规范检查。

    235 GitHub stars~614 tokensUpdated 4 mo ago
    Auto-check passed
  • Frontend Performance Optimization

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 用户需要优化前端性能、提升页面加载速度、减少白屏时间、优化交互流畅度、进行性能排查时。触发场景:前端性能优化、页面加载慢、白屏时间长、卡顿、LCP/FID/CLS指标优化、前端性能分析、打包体积优化。

    235 GitHub stars~701 tokensUpdated 4 mo ago
    Auto-check passed
  • Prd Engineer

    ProgrammerAnthony/Expert-Coding-Harness

    A skill your agent uses when 用户需要编写产品需求文档、整理功能需求、拆解 GitHub Issues 或制定实施计划时。触发场景:写PRD、产品需求、需求文档、prd、需求分析、功能设计、产品设计、需求评审、需求拆解、issue拆解、帮我写需求、整理功能点、我有个想法要落地、新功能规划。

    235 GitHub stars~624 tokensUpdated 4 mo ago
    Auto-check passed

Categories

Questions about Architecture Advisor

What does Architecture Advisor do?

A skill your agent uses when 用户需要设计新系统架构、评审或优化已有系统架构、选择技术方案时。触发场景:架构分析、架构设计、系统设计、architecture、架构优化、系统架构、架构评审、架构咨询、技术方案、技术设计、如何组织代码结构、模块划分、服务拆分、数据库选型、微服务设计。. Architecture Advisor is an agent skill from ProgrammerAnthony/Expert-Coding-Harness.

When should I use Architecture Advisor?

Architecture Advisor fits situations like: 用户需要设计新系统架构、评审或优化已有系统架构、选择技术方案时。触发场景:架构分析、架构设计、系统设计、architecture、架构优化、系统架构、架构评审、架构咨询、技术方案、技术设计、如何组织代码结构、模块划分、服务拆分、数据库选型、微服务设计; tasks that involve Domain-driven design.

How do I install Architecture Advisor in Claude Code?

Run `npx skills add ProgrammerAnthony/Expert-Coding-Harness --skill architecture-advisor -a claude-code`. Or copy the skill folder (skills/architecture-advisor in ProgrammerAnthony/Expert-Coding-Harness) into .claude/skills/architecture-advisor in your project. Claude Code loads it when a task matches its description.

How do I install Architecture Advisor in Codex?

Run `npx skills add ProgrammerAnthony/Expert-Coding-Harness --skill architecture-advisor -a codex`. Or copy the skill folder (skills/architecture-advisor in ProgrammerAnthony/Expert-Coding-Harness) into .agents/skills/architecture-advisor in your project. Codex loads it when a task matches its description.

Can I use Architecture Advisor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ProgrammerAnthony/Expert-Coding-Harness --skill architecture-advisor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/architecture-advisor, .gemini/skills/architecture-advisor, .github/skills/architecture-advisor and .opencode/skills/architecture-advisor in your project.

What does Architecture Advisor need to run?

SKILL.md names no scripts, command-line tools or credentials: Architecture Advisor is instructions for the agent only.

Does Architecture Advisor access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Architecture Advisor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Architecture Advisor use?

Architecture Advisor is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Architecture Advisor use?

About 673 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.9k tokens, read only when the agent opens those files.

What are the alternatives to Architecture Advisor?

Skills that share tags, products or a category with Architecture Advisor: Domain Modeling (fossasia/eventyay-interpretation, 1.6k stars), Architecture Governance (zai-org/ZCode, 7.5k stars), Evolutionary Modular Architecture (tech-leads-club/agent-skills, 7k stars) and Domain Modeling (brim-borium/spotify_sdk, 166 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Architecture Advisor?

ProgrammerAnthony (a GitHub user) maintains it in ProgrammerAnthony/Expert-Coding-Harness, which has 235 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on May 11, 2026.

Source: ProgrammerAnthony/Expert-Coding-Harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.