通用工程师 开发规范与代码质量

角色 该共享技能拥有所有WelineFramework工程工作的基线开发标准。它保持更改小、隔离、框架兼容、在正确位置记录，并在专家技能完成工作之前提供相关验证证据。 何时使用 用于开发标准、代码质量、实现边界、安全重构、生成代码规则、文档职责和验证期望。用于关键字，如编码标准、开发规则、生成代码、模块边界、小更改、验证证据、文档更新、修复报告、WLS测试实例和存储库卫生。当任务跨多个角色或请求主要是关于如何实现工作而不是特定子系统时使用。在专家实现技能之前，当任务可能影响框架稳定性、业务模块、公共接口、运行时行为或用户可见行为时使用。 源材料 AI-ENTRY.md、AI-README.md、CLAUDE.md、dev/ai/skills/_index.md、dev/ai/skills/README.md、dev/ai/skills/MIGRATION_REPORT.md、dev/ai/skills/CI发布工程师-环境兼容与命令安全/SKILL.md。原始迁移源由MIGRATION_REPORT.md引用：code-generation-standards、documentation-standards、debug-logging、windows-command-quoting、php84-performance、testing、module-development和weline-framework-core。 职责 在深入源代码检查之前强制执行存储库的阅读顺序。在正确的模块或框架边界内保持更改。更喜欢小、隔离、可测试的更改而不是广泛的重写。保护生成代码、模式约定、路由约定和模板约束。确保用户面向的文本、文档更新和验证证据由正确的角色或技能处理。在共享标准明确后，决定哪个专家技能应该拥有实现。 工作流程 先阅读AI-ENTRY.md，然后检查图表和模块文档，然后再阅读源代码。确定目标是框架级代码、业务模块、运行时行为、前端/主题工作、文档、测试还是自动化。定义最小的安全更改边界，并避免跨越模块所有权，除非任务需要。检查适用于目标文件的Weline约束，例如生成代码、路由、i18n、模板、WLS、模式和文档规则。选择负责的专家技能进行实现、测试、文档或接受。实现后，需要与受影响的表面相匹配的证据：单元测试、E2E、HTTP验证、WLS验证、命令输出或文档检查。报告更改的行为、验证证据、文档更新和任何剩余的风险或跳过的检查。 Weline规则 先阅读AI-ENTRY.md。更喜欢图表和模块文档而不是源代码。不要直接编辑生成/。不要使用routes.xml。不要通过生成文件或直接Setup/Upgrade.php字段编辑来更改模式；使用模型属性，如#[Col]，并在相关位置运行setup:upgrade。不要使用JavaScript alert、confirm或prompt。不要硬编码用户面向的文本；使用i18n，如__('text')、text或正确的框架安全表单。不要在.phtml文件内添加declare(strict_types=1)。不要在WLS运行时敏感代码内使用sleep、die或exit。不要将详细的修复报告写入存储库根目录。将修复报告写入相关模块doc/目录。修复bug后更新模块README。设计更改时更新架构文档。接口更改时更新API文档。不要使用默认的WLS端口9501进行AI测试。始终使用唯一的名称（如ai-test-{timestamp}）启动专用的WLS测试实例（端口9502+），并在需要WLS验证时停止专用的WLS测试实例。不要污染全局状态。保持模块边界完整。提供单元测试和E2E或HTTP验证证据（如有必要）。 所需输入 任务目标、受影响的模块或框架区域和预期行为。任何相关图表、模块文档、README条目或以前的迁移注释。可能被触及的文件或命令。验证表面：单元测试、HTTP路由、WLS实例、浏览器/E2E流程、CLI命令或文档审查。技术总监或技术负责人如果工作是更大计划的一部分的约束。 预期输出 符合标准的实现计划或完成的更改边界。当实现被委托或分割时，明确的所有权移交到适当的专家角色。避免生成代码编辑、全局状态污染和不必要的广泛重写的代码更改。在模块文档、架构文档、API文档或README文件中根据需要更新文档。与受影响的行为相关的验证证据，而不是一般性声明。更改行为、运行测试、跳过检查和剩余风险的简明报告。 验证 确认更改遵循所需的标准。