框架核心工程师 - 路由事件与扩展

角色 该技能拥有 WelineFramework 中的路由定义模式、事件契约、钩子命名和基于扩展的扩展点。它保持框架的可扩展性明确、可预测和兼容设置驱动的路由注册。 何时使用 用于路由创建、后端/前端 URL 行为、事件设计、钩子放置和扩展点定义。用于诸如路由、控制器 URL、getUrl、getBackendUrl、事件、观察者、钩子、扩展和扩展点等关键字。 当更改影响模块与框架入口点集成时使用。 来源材料 AI-ENTRY.md CLAUDE.md dev/ai/skills/weline-routing/SKILL.md dev/ai/skills/extension-points/SKILL.md dev/ai/skills/weline-framework-core/SKILL.md 职责 通过环境驱动的框架注册设计路由，而不是使用 XML 路由文件。定义事件、钩子和扩展契约，具有稳定的命名和文档。保持查询提供者上的读取式集成和事件上的通知式集成。确保新的扩展点可以被下游模块清晰地实现。 工作流程 确认任务是否属于路由、事件、钩子或扩展契约。阅读 AI-ENTRY.md 和相关图表，然后检查代码。对于路由，更新拥有控制器和模块环境配置。对于事件，定义清晰的名称、有效载荷变量和观察者期望。对于钩子和扩展，定义契约、命名和实现路径，以及支持文档。根据需要运行路由或框架注册命令。通过 HTTP 请求、设置驱动的路由刷新或目标扩展路径检查进行验证。 Weline 规则 不使用 routes.xml。通过 etc/env.php 配置模块路由器。在添加或更改控制器后运行 php bin/w setup:upgrade --route 以刷新路由。使用事件进行通知，使用查询提供者进行跨模块读取。设计更改时保持扩展点文档更新。 输入要求 拥有模块和受影响的入口路径。预期路由、事件、钩子或扩展行为。调用区域，例如前端、后端、API 或集成模块。新建或更改的契约的验证路径。 预期输出 更新的路由或扩展点实现。所需的契约文档或钩子元数据。验证证据，表明路由或扩展路径是可达的。 验证 运行 php bin/w setup:upgrade --route 当路由注册更改时。运行 php bin/w http:request ... 或等效检查路由行为。确认事件有效载荷是基于变量的，观察者可以安全地使用它们。确认钩子和扩展命名匹配框架约定。 约束 不添加 routes.xml。不创建数据查询事件，而是使用适当的查询提供者。不定义未文档化的扩展点用于公共重用。不要在需要框架 URL 帮助程序的地方硬编码 URL。