php-full-stack-developer

核心用法

php-full-stack-developer 是一套面向 OpenClaw 平台的 PHP 全栈开发治理操作系统，采用"预飞分析（Pre-Flight）"方法论，强制要求在任何工程工作开始前完成目标定义、验收标准、风险评估和验证方案。Skill 通过 P0-P3 四级风险分级体系，将安全事件、数据损坏、服务中断列为最高优先级，同时配备明确的"停工规则"——当授权规则不清、数据库变更有破坏性、API 契约消费者未知等条件触发时，必须暂停工作并记录冲突。

实际使用中，开发者需在每次会话开始时回答两个治理问题：是否将工作记录到项目记忆库，以及是否立即执行或启动专用 Agent 以获取更高质量输出。Skill 提供完整的模板体系，包括任务规范、架构决策记录（ADR）、PR 模板等，确保跨会话的可复现性。

显著优点

治理驱动而非工具堆砌：区别于普通代码生成工具，该 Skill 将软件工程的最佳实践固化为强制流程，显著降低因沟通不足、风险识别遗漏导致的返工成本。

安全左移设计：通过扩展/收缩迁移模式、幂等性契约规范、分阶段发布等机制，将安全和稳定性考量前移至设计阶段，而非事后补救。

可审计的决策链：冲突日志、决策日志、活动日志的三层记录体系，使项目演进过程完全可追溯，特别适合合规要求严格的团队。

零执行风险：纯 Markdown 文档架构，无代码执行能力，从根本上杜绝了供应链攻击中的常见攻击向量。

潜在缺点与局限性

认知门槛较高：预飞分析和风险分级要求开发者具备一定经验，新手团队可能需要额外培训才能有效运用，存在"为了安全而降低效率"的短期摩擦。

依赖人工执行：Skill 仅提供指导框架，所有停工判断、日志记录、测试执行均需人工完成，无法强制阻止违规操作，治理效果取决于团队纪律性。

PHP 生态绑定：虽然通用治理原则可迁移，但模板和示例深度绑定 PHP/Laravel 技术栈，对使用其他语言的团队参考价值有限。

无自动化集成：缺乏与 CI/CD 流水线、代码审查工具的原生集成，治理流程与现有 DevOps 工具链的衔接需要额外开发。

适合的目标群体

• 中大型 PHP 开发团队：需要统一交付标准、降低跨成员协作成本的组织
• 金融/医疗等合规敏感行业：对审计追踪、变更回滚有强制要求的场景
• 技术债务较重的遗留项目：希望通过治理框架逐步改善代码质量的管理者
• 远程/异步协作团队：依赖详细文档和结构化沟通弥补实时交流不足

使用风险

流程僵化风险：过度依赖预飞检查可能导致简单任务流程冗长，建议对 P3 级低风险工作适当简化。

日志管理负担：多维度日志要求持续维护，若团队缺乏专人负责，可能沦为形式。

与快速迭代的张力：在需要紧急热修复的场景下，完整的治理流程可能与业务时效性冲突，需预先定义例外机制。

版本漂移：Skill 文档与项目实际代码库可能不同步，建议定期复核 INFO 系列文件的适用性。