agentleFS
wxxzywxxzy/Claude-Code-Software-Studios/.claude/skills/studio-arch-design/SKILL.md

studio-arch-design

Skill1 starsChanged 3 months agoMITView on GitHub

【Studio】架构设计 — API 契约、数据模型、ADR → docs/arch/ADR-*.md。当用户说「设计架构/定义 API」时使用。

The file

Files
SKILL.md

技能:架构设计与选型 (/studio-arch-design)

执行代理: technical-architect (技术架构师)


概述 (Summary)

此技能用于在 PRD 批准后,由架构师引导用户进行深度的架构设计、API 定义或数据库建模。

协作工作流 (The 5-Step Protocol)

  1. 需求分析: 架构师阅读 PRD,识别核心技术挑战。
  2. 提问 (Question): 针对性能、并发或安全性,确认用户的特定约束。
  3. 方案 (Options):
    • 架构师提供 2-3 个对比方案。
    • [强制]:必须使用 ask_user 工具提供这些方案的选择按钮。
  4. 决策 (Decision): 用户通过交互式组件做出选择。
  5. 详细设计 (Draft):
    • 架构师根据选择编写 ADR (Architecture Decision Record) 草案。
    • [强制]:必须使用 ask_user 工具提供 [批准设计]、[需要微调]、[放弃方案] 选项。
  6. 执行与归档: 获得点击批准后,将 ADR 写入 docs/arch/。

成功门控 (Success Gate)

  • 生成了 docs/arch/ADR-xxx.md。
  • 包含了核心 API 契约或数据库结构描述。
  • 用户通过 ask_user 明确表示了批准。

输出约束 (Output Budget)

[强制] 获得批准并写入文件后,返回主上下文只输出:

架构决策已记录。

- `docs/arch/ADR-[xxx].md` — [决策标题,一句话]
- 核心方案:[选定方案名称]
- 关键权衡:[一句话]

如需查看完整设计,打开上述文件。

不得在返回摘要中重复 ADR 正文内容。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.