返回技能目录
人工审校软件开发

技能研究档案

architecture-designer

来源声明

Use when designing new high-level system architecture, reviewing existing designs, or making architectural decisions. Invoke to create architecture diagrams, write Architecture Decision Records (ADRs), evaluate technology trade-offs, design component interactions, and plan for scalability. Use for system design, architecture review, microservices structuring, ADR authoring, scalability planning, and infrastructure pattern selection — distinct from code-level design patterns or database-only design tasks.

保留作者的英文原始描述。它表达设计意图,不代表已验证的实际效果。

Use when designing new high-level system architecture, reviewing existing designs, or making architectural decisions. Invoke to create architecture diagrams, write Architecture Decision Records (ADRs), evaluate technology trade-offs, design component interactions, and plan for scalability. Use for system design, architecture review, microservices structuring, ADR authoring, scalability planning, and infrastructure pattern selection — distinct from code-level design patterns or database-only design tasks.

developmentreferences

研究摘要

人工审校

Skill Atlas editorial review · editorial-preview-1.0.0

协助进行高层系统设计与架构评审,产出需求摘要、Mermaid 架构图以及写明取舍的架构决策记录(ADR)。

审阅范围

对所收集的 SKILL.md 及辅助文本/代码进行确定性静态分析。机器辅助候选和发现等待人工编辑复核;不评估动态行为或效果。

可观察能力

  • 收集功能、非功能与约束需求,并检查覆盖是否完整。
  • 借助参考文件,将需求与架构模式匹配。
  • 产出架构图,首选 Mermaid。
  • 为关键决策撰写 ADR,若评审未通过则回到设计步骤。

限制与范围

  • 干系人评审是人工环节,Skill 只能提示而无法代为完成。
  • 明确区别于代码级设计模式和纯数据库设计,这些不在其范围内。
  • 推荐方案未经真实负载或成本数据验证。

适用读者

  • 架构师与技术负责人
  • 希望用 ADR 记录决策的团队
  • 正在比较单体与微服务方案的工程师

技能包含哪些内容

文件清单来自记录提交中的采集源码。路径与大小属于结构观察,不代表质量评价。

个文件
6
Markdown 文件
6
个脚本
0
个引用
5
大小
20.4 KB
结构复杂度
低

文件清单

路径类型字节
skills/architecture-designer/references/adr-template.md引用2.7 KB
skills/architecture-designer/references/architecture-patterns.md引用4.5 KB
skills/architecture-designer/references/database-selection.md引用2.5 KB
skills/architecture-designer/references/nfr-checklist.md引用3 KB
skills/architecture-designer/references/system-design.md引用2.9 KB
skills/architecture-designer/SKILL.md指令4.8 KB

SKILL.md 前置元数据

{
  "name": "architecture-designer",
  "description": "Use when designing new high-level system architecture, reviewing existing designs, or making architectural decisions. Invoke to create architecture diagrams, write Architecture Decision Records (ADRs), evaluate technology trade-offs, design component interactions, and plan for scalability. Use for system design, architecture review, microservices structuring, ADR authoring, scalability planning, and infrastructure pattern selection — distinct from code-level design patterns or database-only design tasks.",
  "license": "MIT",
  "metadata": {
    "author": "https://github.com/Jeffallan",
    "company": "https://synergetic.solutions",
    "version": "1.1.1",
    "domain": "api-architecture",
    "triggers": "architecture, system design, design pattern, microservices, scalability, ADR, technical design, infrastructure",
    "role": "expert",
    "scope": "design",
    "output-format": "document",
    "related-skills": "fullstack-guardian, devops-engineer, secure-code-guardian, microservices-architect, code-reviewer"
  }
}

对运行顺序的一种解读

此工作流根据源码材料重建表面顺序。除非明确记录受控评估,否则它属于暂定解读,而非真实运行轨迹。

  1. 01
    输入

    理解需求

    收集功能、非功能与约束需求,并确认覆盖完整。

  2. 02
    操作

    带取舍地设计

    完成架构设计,明确记录取舍,并产出架构图。

  3. 03
    判断

    与干系人评审

    若评审未通过,带着记录的反馈回到设计步骤。

  4. 04
    输出

    交付设计包

    交付需求摘要、架构图、关键决策、技术选型理由与风险。

潜在风险面

静态发现用于提示安装前需要检查的位置,不能证明一项技能安全、恶意或有效。

有需要复核的项目

收集的文本中有 20 项确定性词法发现需要复核。发现可能仅位于文档中,不证明已执行或可被利用;仅含二进制的文件未扫描。

网络访问已观察到
文件写入已观察到
凭据使用未观察到
中

文本提及网络访问

5 次命中

此源文件行包含 URL 或网络客户端。应检查目标地址、发送的数据和信任边界;静态文本无法证明实际发生了网络活动。 该规则在收集文本中命中 5 处;此处列出 3 个代表位置。命中文本可能只是文档,分析器没有执行它。

提示

文本描述或实现了文件修改

15 次命中

此行包含可能的文件写入或重定向操作。应检查目标路径和覆盖行为;静态审查没有写入任何文件。 该规则在收集文本中命中 15 处;此处列出 3 个代表位置。命中文本可能只是文档,分析器没有执行它。

编辑安全提示

确认其列出的安全考量由具备资质的人审阅,因为该 Skill 只是提醒不要跳过安全环节。

上下文可能消耗在哪里

发现、激活与资源层具有不同含义。只有使用指定官方方法并记录模型的运行时,才显示精确数值。

精确 token 计数不可用

在管线使用明确模型执行官方精确计数之前,包括文件清单在内的所有 token 值均为 null。

未使用要求的官方方法记录 token 测量。本档案不会用字符数、文件大小或估计值替代。

受控评估

没有受控评估

该技能仅具备以上标明的证据。不声称任何任务成功率、token 效率、延迟或质量优势。

尚未测试

在源码可见的情况下使用

安装命令
git clone https://github.com/Jeffallan/claude-skills.git cd claude-skills # 将该 Skill 目录复制到以下任一位置: # ~/.claude/skills/architecture-designer # .claude/skills/architecture-designer
  1. 打开固定版本源码:https://github.com/Jeffallan/claude-skills/blob/67c1961b180dc92cf08983344627109e983e8f51/skills/architecture-designer/SKILL.md。
  2. 审阅许可证、前置条件和所有捆绑的参考文件。
  3. 将 Skill 安装到个人或项目级 Claude Code skills 目录。
  4. 重启或刷新 Claude Code,使该 Skill 可被发现。
验证安装

确认目标位置存在 architecture-designer/SKILL.md,然后让 Claude Code 在一个小型测试任务中使用 architecture-designer Skill。

前置条件

  • 干系人评审是人工环节,Skill 只能提示而无法代为完成。
  • 明确区别于代码级设计模式和纯数据库设计,这些不在其范围内。
  • 推荐方案未经真实负载或成本数据验证。

示例提示词

代表性任务

Use the architecture-designer skill to propose an architecture for an order-processing platform with an API gateway, auth and notification services, include a Mermaid diagram and ADR-001 for the datastore choice.

使用前检查

Read the architecture-designer skill at https://github.com/Jeffallan/claude-skills/blob/67c1961b180dc92cf08983344627109e983e8f51/skills/architecture-designer/SKILL.md and its referenced files. Explain its workflow, required tools, permissions and the main risks before I decide whether to install it.

附上限制条件的判断

优势

  • 要求考虑取舍、故障模式和运维成本,而不只看收益。
  • 提供具体的 Mermaid 与 ADR 模板。

注意事项

  • 角色设定中的 15 年以上经验只是角色包装,并非真实能力。
  • 输出质量取决于所提供需求的完整程度。
研究结论

一套规范的架构文档模板,在预先提供真实约束时最有价值。

从结构上保持可追溯

档案是对公开工件的限时阅读,而非背书。请通过来源链接检查确切的上游材料。

Jeffallanclaude-skillsskills/architecture-designer
来源类型
社区
提交
67c1961b180dc92cf08983344627109e983e8f51
采集时间
2026年11月20日
最近核查
2026年11月20日
上游许可证
MIT
仓库星标
12,464
内容依据

仅对提供的文件进行确定性词法解析、YAML frontmatter 校验、文件清单、来源描述的工作流程提取和启发式暂定分类。由机器生成;无 LLM、执行、动态测试或人工编辑批准。