用途:在功能实现前统一进行设计,覆盖组件架构、REST API 契约与数据模型(Pydantic schema)。
主要能力:支持自动检测项目上下文或显式指定模式。用法:/design 自动检测并显示摘要;/design architecture 组件架构、SOLID、模式;/design api REST API 设计、认证、限流;/design data Pydantic schema、验证器、关系;/design full 按架构→数据→API 顺序全部执行。
工作流:先确定模式,无参数时运行 DETECTED=$(bash "$HOME/.claude/skills/design/lib/design-detector.sh") 检测,并按结果推荐模式(pydantic,fastapi 建议 api+data;仅 pydantic 建议 data;fastapi/flask/django 建议 api;通用 Python/Node 建议 architecture;未知则展示全部摘要)。随后按渐进披露展示:L1 摘要(默认,约15行,读取 templates/architecture/summary.md 等);L2 模式(按需,约50行,读取 patterns.md);L3 完整参考(按需,读取 reference/ 下文档)。多领域时展示各摘要并让用户选择深入,或用 /design full。
输出:写入项目根目录 docs/architecture/,architecture 输出 architecture-{feature}.md,api 输出 api-{feature}.md,data 输出 data-{feature}.md,full 输出 {feature}.md(合并)。使用 templates/architecture-doc.md 模板,含概述、架构模式、组件设计、数据模型、API 规范、数据流、模块结构、错误处理、配置、测试策略、安全与性能考虑等章节;目录不存在则创建。
集成:可由用户直接调用或 /story prp 工作流设计阶段调用;不直接调用其他技能,产出的架构文档供 prp-generator 使用,/implementation 消费设计输出。
限制:渐进披露规则要求未明确请求完整 SOP 或 L3 时不加载 reference/ 文档;默认 L1 摘要,用户询问“如何/什么模式/示例”时用 L2,请求“完整指南/完整参考”或特定深入主题时用 L3。其余细节暂未提供。