AI 插件开发工具插件系统【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址https://gitcode.com/GitHub_Trending/cl/claude-plugins-official点击查看免费下载code-architect 是官方 feature-dev 插件中负责特性架构设计的专职 Agent它通过分析既有代码库的模式与约定输出包含具体文件改动、组件设计、数据流与构建顺序的完整实现蓝图。本文结合仓库中的 Agent 定义、命令工作流与配套文档逐层拆解它的角色定位、frontmatter 配置、系统提示词设计、七要素输出规范以及在 7 阶段特性开发工作流中的实际调用方式帮助你理解并直接复用它来为复杂特性做架构决策。一、code-architect 在 feature-dev 插件中的定位feature-dev 插件位于 plugins/feature-dev把一次特性开发组织为 7 个阶段Discovery需求澄清、Codebase Exploration代码库探索、Clarifying Questions澄清问题、Architecture Design架构设计、Implementation实现、Quality Review质量评审与 Summary总结。code-architect 正是Phase 4 架构设计阶段的核心执行者它的职责是基于既有代码库的模式与约定设计特性架构并给出完整的实现蓝图。与负责摸清现状的 code-explorerPhase 2、负责事后质检的 code-reviewerPhase 6不同code-architect 站在设计与决策的位置上它不仅要读懂代码库还要做出果断的架构选择并把决策细化到每一个文件、每一个函数、每一步构建顺序。该 Agent 的完整定义存放在 agents/code-architect.md是一个带 YAML frontmatter 的 Markdown 文件正文即系统提示词——这正是 Claude Code 插件 Agent 的标准形态可参考 agent-development SKILL 中的结构规范。二、frontmatter 配置逐项解读code-architect.md 的 frontmatter 定义了 Agent 的元信息各项字段含义如下--- name: code-architect description: Designs feature architectures by analyzing existing codebase patterns and conventions, then providing comprehensive implementation blueprints with specific files to create/modify, component designs, data flows, and build sequences tools: Glob, Grep, LS, Read, NotebookRead, WebFetch, TodoWrite, WebSearch, KillShell, BashOutput model: sonnet color: green ---字段值说明namecode-architectAgent 标识符小写字母加连字符用于命名空间与触发description见上文定义 Agent 的触发条件与能力概述是触发机制中最关键的字段toolsGlob, Grep, LS, Read, NotebookRead, WebFetch, TodoWrite, WebSearch, KillShell, BashOutput允许使用的工具白名单modelsonnet指定运行模型此处为 Claude Sonnet均衡性能colorgreenUI 中的视觉标识色绿色通常表示面向成功导向的任务几点值得注意的实现细节工具集是只读分析 任务管理的组合Glob、Grep、LS、Read 用于搜索与阅读代码NotebookRead 支持读取 notebookWebFetch、WebSearch 允许查阅外部资料TodoWrite 用于拆解并跟踪设计任务进度KillShell、BashOutput 则用于管理可能产生的 Shell 进程。与直接改代码的 Agent 相比它没有 Write 类工具——从工具清单可以推断code-architect 的职责边界是产出设计蓝图而非直接落盘代码这与 Phase 5 由主流程负责实现的分工一致。model 取sonnet而非inherit根据 agent-development SKILL 的说明模型可选inherit继承父级推荐默认、sonnet均衡、opus最强最贵、haiku最快最省。架构设计需要一定的推理深度此处显式指定 sonnet说明插件作者认为该任务需要比 haiku 更强的能力但不必动用 opus。color 用绿色SKILL 中建议同类 Agent 使用一致颜色绿色对应成功导向任务。配合 code-explorer 的黄色分析/验证与 code-reviewer 的红色关键/安全三个 Agent 在 UI 上一目了然。三、系统提示词剖析三步核心流程code-architect.md 正文开篇即定义人格You are a senior software architect who delivers comprehensive, actionable architecture blueprints by deeply understanding codebases and making confident architectural decisions.资深软件架构师通过深入理解代码库做出自信的架构决策交付全面、可执行的架构蓝图。随后给出三步核心流程这是整个 Agent 行为的主干1. Codebase Pattern Analysis代码库模式分析第一步是先读后设计提取既有代码库中的模式、约定与架构决策识别技术栈、模块边界、抽象层以及 CLAUDE.md 中的项目规范同时查找相似特性理解项目既有的实现思路。这一步直接决定了后续设计的贴合度——feature-dev 的 README 明确要求遵循 Phase 2 发现的模式进行实现而 Phase 2 的探索成果正是由 code-explorer 提供的。code-architect 的模式分析可以视为对探索结果的进一步消化与提炼输出时要求附上file:line级别的引用证据。2. Architecture Design架构设计第二步是决策环节强调果断做出决定性的选择选定一种方案并贯彻到底Make decisive choices - pick one approach and commit确保与既有代码无缝集成同时为可测试性、性能与可维护性而设计。选定一种方案并贯彻是 code-architect 最鲜明的行为准则——它刻意避免输出模棱两可的多选一。结合 feature-dev.md 命令 的说明多个候选方案并非由单个 Agent 内部纠结而是通过并行启动多个不同侧重点的 code-architect来实现分别以 minimal changes最小改动、最大复用、clean architecture可维护性、优雅抽象、pragmatic balance速度与质量兼顾为各自视角再由主流程汇总对比、给出推荐。3. Complete Implementation Blueprint完整实现蓝图第三步把设计落成可执行产物指明每个要创建或修改的文件、组件职责、集成点与数据流并把实现拆解为清晰的阶段与具体任务。蓝图必须具体到可直接开工——包含文件路径、函数名与具体步骤而非抽象描述。四、输出指南架构蓝图的七要素code-architect.md 规定输出必须包含七个要素任何一次设计任务都应覆盖完整Patterns Conventions Found发现的模式与约定既有模式及其file:line引用、相似特性、关键抽象Architecture Decision架构决策选定的方案及其理由与权衡Component Design组件设计每个组件的文件路径、职责、依赖与接口Implementation Map实现地图具体要创建/修改的文件及详细的变更描述Data Flow数据流从入口经各层变换到输出的完整链路Build Sequence构建顺序分阶段的实现步骤清单Critical Details关键细节错误处理、状态管理、测试、性能与安全考量。这七个要素环环相扣前两项回答为什么这样设计中间三项回答改哪里、怎么改最后两项回答按什么顺序改、改的时候注意什么。一个完整的 code-architect 输出本质上就是一份可以直接交给实现者执行的施工图纸。五、在 7 阶段工作流中的实际调用方式5.1 Phase 4 的并行设计方案根据 feature-dev.md 命令 中 Phase 4 的定义架构设计阶段的操作是并行启动 2-3 个 code-architect Agent各自采用不同侧重点minimal changes最小改动、最大复用、clean architecture可维护性、优雅抽象或 pragmatic balance速度 质量汇总所有方案并形成主流程自己的判断考虑修复规模、紧迫性、复杂度与团队上下文向用户呈现每个方案的简要说明、权衡对比、带理由的推荐以及具体的实现差异询问用户倾向哪个方案获得确认后才进入实现。README 中给出了 Phase 4 的示例输出展示三种方案如何对比以 OAuth 认证特性为例Approach 1: Minimal Changes - Extend existing AuthService with OAuth methods - Add new OAuth routes to existing auth router - Minimal refactoring required Pros: Fast, low risk Cons: Couples OAuth to existing auth, harder to test Approach 2: Clean Architecture - New OAuthService with dedicated interface - Separate OAuth router and middleware - Refactor AuthService to use common interface Pros: Clean separation, testable, maintainable Cons: More files, more refactoring Approach 3: Pragmatic Balance - New OAuthProvider abstraction - Integrate into existing AuthService - Minimal refactoring, good boundaries Pros: Balanced complexity and cleanliness Cons: Some coupling remains Recommendation: Approach 3 - gives you clean boundaries without excessive refactoring, and fits your existing architecture well.这正是多个 code-architect 各执一策、主流程汇总推荐的落地形态每个 Agent 各自选定一种方案并贯彻用户则在三份有明确 trade-off 的蓝图之间做最终选择。5.2 与前后阶段 Agent 的协作链路从 feature-dev 的命令定义与 README 可以梳理出完整的协作链路输入来自 code-explorerPhase 2并行启动 2-3 个 code-explorer 分别探索相似特性、架构抽象与既有实现返回带file:line引用的分析与必须阅读的文件清单主流程读完这些文件后把理解沉淀为 Phase 3 的澄清问题最终把确认过的需求交给 Phase 4 的 code-architect。输出交给实现与质检Phase 5-6实现阶段按选定的架构蓝图施工随后由 3 个 code-reviewer 并行从简洁性/DRY/优雅、Bug/正确性、项目约定/抽象三个角度评审用置信度过滤仅报告 ≥80 的发现控制噪音——相当于对蓝图执行结果的闭环校验。可以这样理解分工code-explorer 回答现状是什么code-architect 回答应该怎么建code-reviewer 回答建得对不对。code-architect 是三者中唯一的决策与设计角色。5.3 手动调用除了在/feature-dev工作流中自动触发code-architect 也可手动调用README 的 Usage Patterns 给出示例Launch code-architect to design the caching layer当你不打算走完整 7 阶段、只想要某个模块的架构方案时这句话即可直接唤起它。触发依据正是 frontmatter 中的 description 字段——它描述了分析代码库模式后产出实现蓝图的能力Claude 会据此判断何时把任务派发给该 Agent。六、使用 code-architect 的最佳实践综合 README 与命令定义高效使用 code-architect 的关键点如下先探索、后设计别跳过 Phase 2/3模式分析的质量取决于输入质量。让 code-explorer 先产出文件清单、主流程先读完关键文件并澄清歧义code-architect 才能给出真正贴合的方案需求描述越具体方案越精准README 明确提示Be specific in your feature request: More detail fewer clarifying questions含糊的需求会让架构决策缺乏锚点信任推荐但保留最终选择权Phase 4 的推荐基于代码库分析得出如果三个方案让你犹豫README 建议pick the pragmatic option when in doubt拿不定就选务实平衡方案关注七要素的完整度拿到蓝图后先核对数据流与构建顺序是否存在——这两项缺失往往意味着设计尚未完全落地适合的场景跨多文件的特性、需要架构决策的功能、与既有代码的复杂集成、需求模糊的特性不适合单行 bug 修复、琐碎改动与紧急 hotfixREADME 明确列出。七、从源码结构看Agent 定义的规范启示code-architect.md 本身也是一份优质的Agent 定义示范其结构严格符合 plugin-dev 的 agent-development SKILL 中的最佳实践frontmatter 完整且克制name、description、model、color、tools五个字段一应俱全description 直接描述触发条件与能力tools 遵循最小权限原则只读分析 任务管理不给写权限系统提示词采用第二人称You are...先定人格、再给流程、后定输出格式层次清晰输出格式被显式规定七要素清单确保每次调用都产出结构一致的蓝图便于主流程汇总与用户阅读强调果断决策的行为准则贯穿全文decisive、confident、commit与 feature-dev 插件的整体理念先想清楚再动手高度一致。如果你的插件也需要一个架构设计型子 Agent可以直接以 code-architect.md 为模板把三步核心流程替换为你领域的分析-设计-产出流程把七要素输出清单替换为你的交付物清单并沿用只读工具 TodoWrite的权限组合。结语code-architect 体现了 feature-dev 插件理解先行、设计先行的核心理念它把拍脑袋写代码替换为基于证据的架构决策 可直接执行的实现蓝图并通过与 code-explorer、code-reviewer 的分工协作把架构质量环节嵌入到特性开发的固定流程中。无论是跟随/feature-dev全流程使用还是单独手动唤起它都是一套可复用的架构设计方法论——读懂它的定义文件你也就掌握了如何为 Claude Code 插件设计一位资深架构师。赞分享AI 插件开发工具插件系统【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址https://gitcode.com/GitHub_Trending/cl/claude-plugins-official点击查看免费下载相关推荐Claude Code 插件开发实战深入解析 feature-dev 的 code-architect 架构设计智能体Claude Code 插件开发实战深入解析 feature dev 的 code architect 架构设计智能体 code architect 是 ClAI 应用AI 技能/插件开发工具Pinpoint Web Frontend v3 代码审查 Agent 设计解析从架构模式到工程约定的 Claude Code 规范实战Pinpoint Web Frontend v3 代码审查 Agent 设计解析从架构模式到工程约定的 Claude Code 规范实战 本篇文章基于 Pin后端可观测性APM链路追踪微服务Screenshot-to-code代码架构分析转换代码的设计模式应用Screenshot to code代码架构分析转换代码的设计模式应用 1. 项目架构概览 Screenshot to code是一个将网页截图转换为代码的工示例工程上一篇MobileOne S0 未来发展方向从S0到S4的演进路线图下一篇Symfony String组件PHP字符串处理的终极解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
