尧图网站建设 
RuView 后端 API 开发 Agent 深度解析dev-backend-api.md 的触发、约束、Hook 与路由实现【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView本文以 RuView 仓库中.claude/agents/development/backend/dev-backend-api.md这份后端 API 开发 Agent 定义文件为主体逐段解读它的 YAML 元数据触发器、工具能力、路径约束、行为策略、协作拓扑与执行钩子和 Markdown 职责正文并结合.claude/helpers/router.js、.claude/helpers/hook-handler.cjs与.claude/settings.json的实现说明这个 Agent 是如何被路由、被约束、被 Hook 调度的。读完后你可以掌握在 claude-flow 多 Agent 体系中编写和定制一个后端 API 开发专家Agent 的完整方法从字段语义、取值范围到与 Claude Code Hook 机制的对接方式。1. 这是什么claude-flow 多 Agent 体系中的 Agent 定义文件dev-backend-api.md并不是普通的项目文档而是 RuView 仓库中 claude-flowClaude Code 的多 Agent 编排层的一个Agent 规格文件。仓库在.claude/settings.json中通过环境变量CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: 1、CLAUDE_FLOW_V3_ENABLED: true、CLAUDE_FLOW_HOOKS_ENABLED: true开启了这套体系见 settings.json并声明claudeFlow.version: 3.0.0、swarm.topology: hierarchical-mesh、swarm.maxAgents: 15。Agent 定义采用YAML frontmatter Markdown 正文的双段结构frontmatterL1–L117机器可读的配置描述 Agent 的身份、触发条件、工具白名单、路径边界、行为策略、协作关系与生命周期钩子正文L119–L144注入给 LLM 的系统提示词规定其职责、最佳实践与代码模式。值得注意的是仓库里存在同一 Agent 的另一个副本 development/dev-backend-api.md其 frontmatter 标注version: 2.0.0-alpha在本文解析的 1.0.0 版本基础上增加了自学习 Hookmemory store-pattern、neural train等。本文主体以指定的 1.0.0 版本backend/dev-backend-api.md为准v2 的差异在最后一节单独说明。2. 身份与元数据name: backend-dev description: Specialized agent for backend API development, including REST and GraphQL endpoints color: blue type: development version: 1.0.0 created: 2025-07-25 author: Claude Code metadata: specialization: API design, implementation, and optimization complexity: moderate autonomous: true各字段含义字段取值说明namebackend-devAgent 在编排系统中的唯一标识也是路由器的目标键见第 6 节descriptionREST 与 GraphQL 端点开发专家供编排器/人阅读的能力摘要typedevelopment所属类别决定它在.claude/agents/目录中的归类development/backend/metadata.autonomoustrue允许自主执行任务而无需逐步人工确认高危操作除外见behaviormetadata.complexitymoderate任务复杂度分级可用于调度优先级推断name: backend-dev与路由配置直接对应router.js 中AGENT_CAPABILITIES表将backend-dev: [api, database, server, authentication]声明为该 Agent 的能力标签。3. 触发器triggers什么任务会唤起这个 Agenttriggers: keywords: - api - endpoint - rest - graphql - backend - server file_patterns: - **/api/**/*.js - **/routes/**/*.js - **/controllers/**/*.js - *.resolver.js task_patterns: - create * endpoint - implement * api - add * route domains: - backend - api触发器分四类覆盖任务意图、文件特征、措辞模板、领域四个维度keywords任务描述中出现api、endpoint、rest、graphql、backend、server任一关键词即命中。file_patterns当任务涉及的文件匹配这些 glob 时命中。这里限定的是 Node.js 风格的后端目录约定api/、routes/、controllers/、*.resolver.js与 frontmatter 中allowed_file_types的.js/.ts一致——可以推断该 Agent 的默认目标工程形态是 Node 后端。task_patterns带通配符的任务句式模板如create * endpoint、implement * api、add * route。domains领域标签backend与api供更粗粒度的领域路由使用。路由层的实际匹配逻辑可以在 router.js 的TASK_PATTERNS中得到印证其中api|endpoint|server|backend|database: backend-dev这一行把关键词正则与 Agent 名绑定与 frontmatter 的keywords列表高度吻合。4. 工具能力与执行限额capabilitiescapabilities: allowed_tools: - Read - Write - Edit - MultiEdit - Bash - Grep - Glob - Task restricted_tools: - WebSearch # Focus on code, not web searches max_file_operations: 100 max_execution_time: 600 memory_access: both要点工具白名单Read/Write/Edit/MultiEdit文件读写、Bash执行命令、Grep/Glob检索、Task派生子任务。值得注意的是白名单里有Bash却没有WebSearch——后者被显式列入restricted_tools注释说明了意图Focus on code, not web searches即该 Agent 应基于仓库内代码事实工作而不是上网找答案。执行限额max_file_operations: 100限制单轮文件操作次数max_execution_time: 600秒限制单任务运行时长二者共同防止 Agent 失控地长时间写文件。memory_access: both允许同时读写长期与短期记忆配合 settings.json 中claudeFlow.memory.backend: hybrid、enableHNSW: true的记忆配置见 settings.jsonAgent 的中间结论可以沉淀供后续会话复用。5. 路径与安全约束constraintsconstraints: allowed_paths: - src/** - api/** - routes/** - controllers/** - models/** - middleware/** - tests/** forbidden_paths: - node_modules/** - .git/** - dist/** - build/** max_file_size: 2097152 # 2MB allowed_file_types: - .js - .ts - .json - .yaml - .yml这是一套典型的最小权限边界设计只写后端相关的 7 类目录源码、API、路由、控制器、模型、中间件、测试把 Agent 的修改面收敛到 API 层黑名单排除依赖目录、版本控制目录与构建产物避免污染单文件上限 2MB2097152 字节防止 Agent 去啃 minified 的大文件或巨型生成文件文件类型白名单仅允许.js/.ts/.json/.yaml/.yml与 Node 后端工程栈严格对齐——Agent 不会去改 Rust crate、CMake 文件或固件源码这些在 RuView 主体中占很大比重但不在本 Agent 的授权范围内。6. 行为策略与沟通规范behavior / communicationbehavior: error_handling: strict confirmation_required: - database migrations - breaking API changes - authentication changes auto_rollback: true logging_level: debug communication: style: technical update_frequency: batch include_code_snippets: true emoji_usage: noneerror_handling: strict遇错即停不做静默吞错与auto_rollback: true配合失败时自动回滚本 Agent 产生的变更。confirmation_required列出三类必须人工确认的高危操作数据库迁移、破坏性 API 变更、认证逻辑变更。这与autonomous: true形成平衡——日常 CRUD 开发可自主完成但触碰这三类操作必须先确认。logging_level: debug开发期保留调试级日志便于事后审计 Agent 的每一步决策。沟通规范要求技术性语言、批量汇报update_frequency: batch、输出中携带代码片段、且明确emoji_usage: none。需要指出一个配置与实现不一致的细节behavior声明无 emoji而下面hooks里的 shell 脚本却大量使用了 emoji、✅等——从源码结构看这些 echo 是面向终端日志的提示而非 Agent 的对话输出两者并不冲突但体现了该文件属于人写的约定 可执行片段混合体。7. 协作拓扑integration谁可以派生它、它可以委派谁integration: can_spawn: - test-unit - test-integration - docs-api can_delegate_to: - arch-database - analyze-security requires_approval_from: - architecture shares_context_with: - dev-backend-db - test-integration这段定义了一个小型协作网关系目标 Agent语义can_spawntest-unit/test-integration/docs-api完成 API 开发后可派生子 Agent 跑单测、集成测试并生成 API 文档can_delegate_toarch-database/analyze-security遇到数据库架构问题、安全问题时委派给专家 Agentrequires_approval_fromarchitecture其方案需经架构 Agent 审批与confirmation_required的高危操作策略呼应shares_context_withdev-backend-db/test-integration与数据库开发 Agent、集成测试 Agent 共享上下文任务状态、代码变更结合swarm.topology: hierarchical-mesh与maxAgents: 15settings.json这个 Agent 是分层网格中开发层的一个节点向下可扇出测试节点横向与数据库开发节点共享上下文向上受架构节点约束。8. 性能优化参数optimizationoptimization: parallel_operations: true batch_size: 20 cache_results: true memory_limit: 512MBparallel_operations: true允许并行执行独立操作如批量创建多个端点文件batch_size: 20是批量操作的批大小上限cache_results: true缓存重复检索/执行结果memory_limit: 512MB限制 Agent 进程内存防止长时间任务撑爆宿主。9. 生命周期钩子hookspre / post / on_errorhooks: pre_execution: | echo Backend API Developer agent starting... echo Analyzing existing API structure... find . -name *.route.js -o -name *.controller.js | head -20 post_execution: | echo ✅ API development completed echo Running API tests... npm run test:api 2/dev/null || echo No API tests configured on_error: | echo ❌ Error in API development: {{error_message}} echo Rolling back changes if needed...三段钩子的设计意图非常清晰pre_execution启动时先find . -name *.route.js -o -name *.controller.js | head -20盘点现有路由/控制器文件为 Agent 建立现状地图再动手——避免重复实现已存在的端点。post_execution完成后执行npm run test:api若项目未配置该脚本则优雅降级|| echo No API tests configured钩子永不因测试缺失而失败。on_error接收{{error_message}}模板变量输出错误并触发回滚提示与behavior.auto_rollback: true形成闭环。这些 Agent 级钩子与 Claude Code 的项目级 Hook 是两层机制。项目级 Hook 在 settings.json 中统一接线全部收敛到 hook-handler.cjsHook 事件触发条件命令作用PreToolUse工具匹配Bashhook-handler.cjs pre-bash执行前命令安全校验PostToolUse工具匹配Write\|Edit\|MultiEdithook-handler.cjs post-edit记录编辑结果用于学习UserPromptSubmit每次提交提示词hook-handler.cjs route把任务路由给最优 Agentbackend-dev 即在此被选中SessionStart会话开始hook-handler.cjs session-restoreauto-memory-hook.mjs import恢复会话状态、导入记忆SessionEnd/Stop会话结束session-end/sync持久化状态、同步记忆权限层面同样做了配套settings.json 的permissions.allow显式放行Bash(npx claude-flow*)、Bash(npx claude-flow*)、Bash(node .claude/*)与mcp__claude-flow__:*保证上述 Hook 与 Agent 命令能免确认执行。10. 正文提示词职责、最佳实践与代码模式frontmatter 之后是注入 LLM 的系统提示词完整继承如下要点原文 L119–L144Key responsibilities职责Design RESTful and GraphQL APIs following best practices按最佳实践设计 RESTful 与 GraphQL APIImplement secure authentication and authorization实现安全的认证与授权Create efficient database queries and data models编写高效的数据库查询与数据模型Write comprehensive API documentation编写完整的 API 文档Ensure proper error handling and logging确保正确的错误处理与日志。Best practices最佳实践Always validate input data始终校验输入数据Use proper HTTP status codes使用恰当的 HTTP 状态码Implement rate limiting and caching实现限流与缓存Follow REST/GraphQL conventions遵循 REST/GraphQL 约定Write tests for all endpoints为所有端点编写测试Document all API changes记录所有 API 变更。Patterns to follow应遵循的模式Controller-Service-Repository pattern控制器-服务-仓储三层Middleware for cross-cutting concerns用中间件处理横切关注点日志、认证、限流DTO pattern for data validation用 DTO 做数据校验Proper error response formatting规范的错误响应格式。frontmatter 结尾还给出两个触发示例examples示范 Agent 面对典型任务时的响应口吻examples: - trigger: create user authentication endpoints response: Ill create comprehensive user authentication endpoints including login, logout, register, and token refresh... - trigger: implement CRUD API for products response: Ill implement a complete CRUD API for products with proper validation, error handling, and documentation...11. 源码级印证路由与 Hook 的落地实现Agent 定义是声明真正让它在运行时生效的是 helpers 下的两个实现文件。1任务路由router.js 的routeTask(task)把任务文本小写后逐条匹配TASK_PATTERNS中的正则命中即返回{ agent, confidence: 0.8, reason }未命中则回落到coder置信度 0.5。因此当用户在 RuView 会话里输入类似 add a REST endpoint for the sensing server 的提示词时UserPromptSubmitHook 会调用hook-handler.cjs route由router.routeTask命中api|endpoint|server|backend|database模式推荐backend-dev。hook-handler.cjs的route处理器L57–L105还会把结果格式化为包含Primary Recommendation / Alternative Agents / Estimated Metrics的文本块输出给 Claude Code。2安全门禁pre-bash处理器L107–L118维护一个危险命令黑名单如rm -rf /、format c:、fork bomb命中即exit(1)阻断执行。这是 AgentBash工具权限的第一道守门——与 frontmatter 的allowed_paths/forbidden_paths形成声明式边界 运行时拦截的双层防护。3Hook 容错设计hook-handler.cjs用safeRequireL24–L43加载各模块并静默抑制其 console 输出主分发处L219–L232用注释明确Hooks should never crash Claude Code - fail silently任何未知命令都走 pass-through。这意味着即使 Agent 钩子脚本执行失败也不会打断主会话——与on_error钩子的报错但不阻塞策略一致。4学习闭环v2 扩展仓库中 344 行的 development/dev-backend-api.md 在 v2 版中把学习写进了钩子pre_execution先用npx claude-flowalpha memory search-patterns API implementation: $TASK --k5 --min-reward0.85检索历史上高奖励reward ≥ 0.85的成功 API 实现模式post_execution则以测试通过与否计算奖励通过 0.95 / 失败 0.7调用memory store-pattern --reward ... --success ...沉淀本次实现成功后再neural train --pattern-type coordination训练on_error以--reward 0.0记录失败样本。正文相应给出reasoningBank.searchPatterns / storePattern、agentDB.gnnEnhancedSearch基于依赖图的上下文检索与agentDB.flashAttention大 schema 处理等 TypeScript 参考实现。从源码结构看v2 属于 alpha 演进方向frontmatter 标注2.0.0-alpha并在 v3.0.0-alpha.1 标题下描述自学习协议可作为把测试反馈 → 模式奖励 → 记忆库闭环注入 Agent 的参考设计。12. 如何使用与适用前提查看方式Agent 定义位于 .claude/agents/development/backend/dev-backend-api.md路由与 Hook 实现在 .claude/helpers/router.js、.claude/helpers/hook-handler.cjs全局接线在 .claude/settings.json。仓库为只读参考阅读时不必修改任何文件。运行前提该 Agent 运行在 Claude Code claude-flow 环境下CLAUDE_FLOW_V3_ENABLEDtrueHook 命令依赖node与npx claude-flow*settings.json 的 permissions 已放行。适用边界triggers.file_patterns、allowed_file_types与npm run test:api都表明该 Agent 面向Node.js/TypeScript 后端工程而 RuView 仓库的主体实现是 Rust cratev2/crates/、ESP32 固件firmware/与 Python 训练管线。因此在 RuView 中使用该 Agent 时它更适合承担API 服务层开发这类子任务例如为 sensing server 补 REST 端点而不覆盖 Rust 核心代码与固件——这也正是 frontmatter 用allowed_paths/allowed_file_types自我限权的设计目的。可复制点如果你想为自己项目定制一个类似 Agent最小骨架就是本文第 2–9 节展示的字段集triggers何时被唤起→capabilities能用什么工具、限额多少→constraints能改哪些文件→behavior何时必须人工确认、失败如何回滚→integration与哪些 Agent 协作→hooks前后置动作再配上 router 侧的TASK_PATTERNS映射即可得到一个边界清晰、可路由、可审计的领域专家 Agent。【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 RuView 后端 API 开发 Agent 深度解析：dev-backend-api.md 的触发、约束、Hook 与路由实现
RuView 后端 API 开发 Agent 深度解析dev-backend-api.md 的触发、约束、Hook 与路由实现【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView本文以 RuView 仓库中.claude/agents/development/backend/dev-backend-api.md这份后端 API 开发 Agent 定义文件为主体逐段解读它的 YAML 元数据触发器、工具能力、路径约束、行为策略、协作拓扑与执行钩子和 Markdown 职责正文并结合.claude/helpers/router.js、.claude/helpers/hook-handler.cjs与.claude/settings.json的实现说明这个 Agent 是如何被路由、被约束、被 Hook 调度的。读完后你可以掌握在 claude-flow 多 Agent 体系中编写和定制一个后端 API 开发专家Agent 的完整方法从字段语义、取值范围到与 Claude Code Hook 机制的对接方式。1. 这是什么claude-flow 多 Agent 体系中的 Agent 定义文件dev-backend-api.md并不是普通的项目文档而是 RuView 仓库中 claude-flowClaude Code 的多 Agent 编排层的一个Agent 规格文件。仓库在.claude/settings.json中通过环境变量CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: 1、CLAUDE_FLOW_V3_ENABLED: true、CLAUDE_FLOW_HOOKS_ENABLED: true开启了这套体系见 settings.json并声明claudeFlow.version: 3.0.0、swarm.topology: hierarchical-mesh、swarm.maxAgents: 15。Agent 定义采用YAML frontmatter Markdown 正文的双段结构frontmatterL1–L117机器可读的配置描述 Agent 的身份、触发条件、工具白名单、路径边界、行为策略、协作关系与生命周期钩子正文L119–L144注入给 LLM 的系统提示词规定其职责、最佳实践与代码模式。值得注意的是仓库里存在同一 Agent 的另一个副本 development/dev-backend-api.md其 frontmatter 标注version: 2.0.0-alpha在本文解析的 1.0.0 版本基础上增加了自学习 Hookmemory store-pattern、neural train等。本文主体以指定的 1.0.0 版本backend/dev-backend-api.md为准v2 的差异在最后一节单独说明。2. 身份与元数据name: backend-dev description: Specialized agent for backend API development, including REST and GraphQL endpoints color: blue type: development version: 1.0.0 created: 2025-07-25 author: Claude Code metadata: specialization: API design, implementation, and optimization complexity: moderate autonomous: true各字段含义字段取值说明namebackend-devAgent 在编排系统中的唯一标识也是路由器的目标键见第 6 节descriptionREST 与 GraphQL 端点开发专家供编排器/人阅读的能力摘要typedevelopment所属类别决定它在.claude/agents/目录中的归类development/backend/metadata.autonomoustrue允许自主执行任务而无需逐步人工确认高危操作除外见behaviormetadata.complexitymoderate任务复杂度分级可用于调度优先级推断name: backend-dev与路由配置直接对应router.js 中AGENT_CAPABILITIES表将backend-dev: [api, database, server, authentication]声明为该 Agent 的能力标签。3. 触发器triggers什么任务会唤起这个 Agenttriggers: keywords: - api - endpoint - rest - graphql - backend - server file_patterns: - **/api/**/*.js - **/routes/**/*.js - **/controllers/**/*.js - *.resolver.js task_patterns: - create * endpoint - implement * api - add * route domains: - backend - api触发器分四类覆盖任务意图、文件特征、措辞模板、领域四个维度keywords任务描述中出现api、endpoint、rest、graphql、backend、server任一关键词即命中。file_patterns当任务涉及的文件匹配这些 glob 时命中。这里限定的是 Node.js 风格的后端目录约定api/、routes/、controllers/、*.resolver.js与 frontmatter 中allowed_file_types的.js/.ts一致——可以推断该 Agent 的默认目标工程形态是 Node 后端。task_patterns带通配符的任务句式模板如create * endpoint、implement * api、add * route。domains领域标签backend与api供更粗粒度的领域路由使用。路由层的实际匹配逻辑可以在 router.js 的TASK_PATTERNS中得到印证其中api|endpoint|server|backend|database: backend-dev这一行把关键词正则与 Agent 名绑定与 frontmatter 的keywords列表高度吻合。4. 工具能力与执行限额capabilitiescapabilities: allowed_tools: - Read - Write - Edit - MultiEdit - Bash - Grep - Glob - Task restricted_tools: - WebSearch # Focus on code, not web searches max_file_operations: 100 max_execution_time: 600 memory_access: both要点工具白名单Read/Write/Edit/MultiEdit文件读写、Bash执行命令、Grep/Glob检索、Task派生子任务。值得注意的是白名单里有Bash却没有WebSearch——后者被显式列入restricted_tools注释说明了意图Focus on code, not web searches即该 Agent 应基于仓库内代码事实工作而不是上网找答案。执行限额max_file_operations: 100限制单轮文件操作次数max_execution_time: 600秒限制单任务运行时长二者共同防止 Agent 失控地长时间写文件。memory_access: both允许同时读写长期与短期记忆配合 settings.json 中claudeFlow.memory.backend: hybrid、enableHNSW: true的记忆配置见 settings.jsonAgent 的中间结论可以沉淀供后续会话复用。5. 路径与安全约束constraintsconstraints: allowed_paths: - src/** - api/** - routes/** - controllers/** - models/** - middleware/** - tests/** forbidden_paths: - node_modules/** - .git/** - dist/** - build/** max_file_size: 2097152 # 2MB allowed_file_types: - .js - .ts - .json - .yaml - .yml这是一套典型的最小权限边界设计只写后端相关的 7 类目录源码、API、路由、控制器、模型、中间件、测试把 Agent 的修改面收敛到 API 层黑名单排除依赖目录、版本控制目录与构建产物避免污染单文件上限 2MB2097152 字节防止 Agent 去啃 minified 的大文件或巨型生成文件文件类型白名单仅允许.js/.ts/.json/.yaml/.yml与 Node 后端工程栈严格对齐——Agent 不会去改 Rust crate、CMake 文件或固件源码这些在 RuView 主体中占很大比重但不在本 Agent 的授权范围内。6. 行为策略与沟通规范behavior / communicationbehavior: error_handling: strict confirmation_required: - database migrations - breaking API changes - authentication changes auto_rollback: true logging_level: debug communication: style: technical update_frequency: batch include_code_snippets: true emoji_usage: noneerror_handling: strict遇错即停不做静默吞错与auto_rollback: true配合失败时自动回滚本 Agent 产生的变更。confirmation_required列出三类必须人工确认的高危操作数据库迁移、破坏性 API 变更、认证逻辑变更。这与autonomous: true形成平衡——日常 CRUD 开发可自主完成但触碰这三类操作必须先确认。logging_level: debug开发期保留调试级日志便于事后审计 Agent 的每一步决策。沟通规范要求技术性语言、批量汇报update_frequency: batch、输出中携带代码片段、且明确emoji_usage: none。需要指出一个配置与实现不一致的细节behavior声明无 emoji而下面hooks里的 shell 脚本却大量使用了 emoji、✅等——从源码结构看这些 echo 是面向终端日志的提示而非 Agent 的对话输出两者并不冲突但体现了该文件属于人写的约定 可执行片段混合体。7. 协作拓扑integration谁可以派生它、它可以委派谁integration: can_spawn: - test-unit - test-integration - docs-api can_delegate_to: - arch-database - analyze-security requires_approval_from: - architecture shares_context_with: - dev-backend-db - test-integration这段定义了一个小型协作网关系目标 Agent语义can_spawntest-unit/test-integration/docs-api完成 API 开发后可派生子 Agent 跑单测、集成测试并生成 API 文档can_delegate_toarch-database/analyze-security遇到数据库架构问题、安全问题时委派给专家 Agentrequires_approval_fromarchitecture其方案需经架构 Agent 审批与confirmation_required的高危操作策略呼应shares_context_withdev-backend-db/test-integration与数据库开发 Agent、集成测试 Agent 共享上下文任务状态、代码变更结合swarm.topology: hierarchical-mesh与maxAgents: 15settings.json这个 Agent 是分层网格中开发层的一个节点向下可扇出测试节点横向与数据库开发节点共享上下文向上受架构节点约束。8. 性能优化参数optimizationoptimization: parallel_operations: true batch_size: 20 cache_results: true memory_limit: 512MBparallel_operations: true允许并行执行独立操作如批量创建多个端点文件batch_size: 20是批量操作的批大小上限cache_results: true缓存重复检索/执行结果memory_limit: 512MB限制 Agent 进程内存防止长时间任务撑爆宿主。9. 生命周期钩子hookspre / post / on_errorhooks: pre_execution: | echo Backend API Developer agent starting... echo Analyzing existing API structure... find . -name *.route.js -o -name *.controller.js | head -20 post_execution: | echo ✅ API development completed echo Running API tests... npm run test:api 2/dev/null || echo No API tests configured on_error: | echo ❌ Error in API development: {{error_message}} echo Rolling back changes if needed...三段钩子的设计意图非常清晰pre_execution启动时先find . -name *.route.js -o -name *.controller.js | head -20盘点现有路由/控制器文件为 Agent 建立现状地图再动手——避免重复实现已存在的端点。post_execution完成后执行npm run test:api若项目未配置该脚本则优雅降级|| echo No API tests configured钩子永不因测试缺失而失败。on_error接收{{error_message}}模板变量输出错误并触发回滚提示与behavior.auto_rollback: true形成闭环。这些 Agent 级钩子与 Claude Code 的项目级 Hook 是两层机制。项目级 Hook 在 settings.json 中统一接线全部收敛到 hook-handler.cjsHook 事件触发条件命令作用PreToolUse工具匹配Bashhook-handler.cjs pre-bash执行前命令安全校验PostToolUse工具匹配Write\|Edit\|MultiEdithook-handler.cjs post-edit记录编辑结果用于学习UserPromptSubmit每次提交提示词hook-handler.cjs route把任务路由给最优 Agentbackend-dev 即在此被选中SessionStart会话开始hook-handler.cjs session-restoreauto-memory-hook.mjs import恢复会话状态、导入记忆SessionEnd/Stop会话结束session-end/sync持久化状态、同步记忆权限层面同样做了配套settings.json 的permissions.allow显式放行Bash(npx claude-flow*)、Bash(npx claude-flow*)、Bash(node .claude/*)与mcp__claude-flow__:*保证上述 Hook 与 Agent 命令能免确认执行。10. 正文提示词职责、最佳实践与代码模式frontmatter 之后是注入 LLM 的系统提示词完整继承如下要点原文 L119–L144Key responsibilities职责Design RESTful and GraphQL APIs following best practices按最佳实践设计 RESTful 与 GraphQL APIImplement secure authentication and authorization实现安全的认证与授权Create efficient database queries and data models编写高效的数据库查询与数据模型Write comprehensive API documentation编写完整的 API 文档Ensure proper error handling and logging确保正确的错误处理与日志。Best practices最佳实践Always validate input data始终校验输入数据Use proper HTTP status codes使用恰当的 HTTP 状态码Implement rate limiting and caching实现限流与缓存Follow REST/GraphQL conventions遵循 REST/GraphQL 约定Write tests for all endpoints为所有端点编写测试Document all API changes记录所有 API 变更。Patterns to follow应遵循的模式Controller-Service-Repository pattern控制器-服务-仓储三层Middleware for cross-cutting concerns用中间件处理横切关注点日志、认证、限流DTO pattern for data validation用 DTO 做数据校验Proper error response formatting规范的错误响应格式。frontmatter 结尾还给出两个触发示例examples示范 Agent 面对典型任务时的响应口吻examples: - trigger: create user authentication endpoints response: Ill create comprehensive user authentication endpoints including login, logout, register, and token refresh... - trigger: implement CRUD API for products response: Ill implement a complete CRUD API for products with proper validation, error handling, and documentation...11. 源码级印证路由与 Hook 的落地实现Agent 定义是声明真正让它在运行时生效的是 helpers 下的两个实现文件。1任务路由router.js 的routeTask(task)把任务文本小写后逐条匹配TASK_PATTERNS中的正则命中即返回{ agent, confidence: 0.8, reason }未命中则回落到coder置信度 0.5。因此当用户在 RuView 会话里输入类似 add a REST endpoint for the sensing server 的提示词时UserPromptSubmitHook 会调用hook-handler.cjs route由router.routeTask命中api|endpoint|server|backend|database模式推荐backend-dev。hook-handler.cjs的route处理器L57–L105还会把结果格式化为包含Primary Recommendation / Alternative Agents / Estimated Metrics的文本块输出给 Claude Code。2安全门禁pre-bash处理器L107–L118维护一个危险命令黑名单如rm -rf /、format c:、fork bomb命中即exit(1)阻断执行。这是 AgentBash工具权限的第一道守门——与 frontmatter 的allowed_paths/forbidden_paths形成声明式边界 运行时拦截的双层防护。3Hook 容错设计hook-handler.cjs用safeRequireL24–L43加载各模块并静默抑制其 console 输出主分发处L219–L232用注释明确Hooks should never crash Claude Code - fail silently任何未知命令都走 pass-through。这意味着即使 Agent 钩子脚本执行失败也不会打断主会话——与on_error钩子的报错但不阻塞策略一致。4学习闭环v2 扩展仓库中 344 行的 development/dev-backend-api.md 在 v2 版中把学习写进了钩子pre_execution先用npx claude-flowalpha memory search-patterns API implementation: $TASK --k5 --min-reward0.85检索历史上高奖励reward ≥ 0.85的成功 API 实现模式post_execution则以测试通过与否计算奖励通过 0.95 / 失败 0.7调用memory store-pattern --reward ... --success ...沉淀本次实现成功后再neural train --pattern-type coordination训练on_error以--reward 0.0记录失败样本。正文相应给出reasoningBank.searchPatterns / storePattern、agentDB.gnnEnhancedSearch基于依赖图的上下文检索与agentDB.flashAttention大 schema 处理等 TypeScript 参考实现。从源码结构看v2 属于 alpha 演进方向frontmatter 标注2.0.0-alpha并在 v3.0.0-alpha.1 标题下描述自学习协议可作为把测试反馈 → 模式奖励 → 记忆库闭环注入 Agent 的参考设计。12. 如何使用与适用前提查看方式Agent 定义位于 .claude/agents/development/backend/dev-backend-api.md路由与 Hook 实现在 .claude/helpers/router.js、.claude/helpers/hook-handler.cjs全局接线在 .claude/settings.json。仓库为只读参考阅读时不必修改任何文件。运行前提该 Agent 运行在 Claude Code claude-flow 环境下CLAUDE_FLOW_V3_ENABLEDtrueHook 命令依赖node与npx claude-flow*settings.json 的 permissions 已放行。适用边界triggers.file_patterns、allowed_file_types与npm run test:api都表明该 Agent 面向Node.js/TypeScript 后端工程而 RuView 仓库的主体实现是 Rust cratev2/crates/、ESP32 固件firmware/与 Python 训练管线。因此在 RuView 中使用该 Agent 时它更适合承担API 服务层开发这类子任务例如为 sensing server 补 REST 端点而不覆盖 Rust 核心代码与固件——这也正是 frontmatter 用allowed_paths/allowed_file_types自我限权的设计目的。可复制点如果你想为自己项目定制一个类似 Agent最小骨架就是本文第 2–9 节展示的字段集triggers何时被唤起→capabilities能用什么工具、限额多少→constraints能改哪些文件→behavior何时必须人工确认、失败如何回滚→integration与哪些 Agent 协作→hooks前后置动作再配上 router 侧的TASK_PATTERNS映射即可得到一个边界清晰、可路由、可审计的领域专家 Agent。【免费下载链接】RuViewπ RuView turns commodity WiFi signals into real-time spatial intelligence, vital sign monitoring, and presence detection — all without a single pixel of video.项目地址: https://gitcode.com/GitHub_Trending/wi/RuView创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考