用途:面向 PHP 项目的周期性依赖健康检查,生成每周 Composer 依赖审计摘要,帮助团队了解直接依赖是否过期、是否存在已知安全公告,并规划安全的升级路径。
主要能力:
- 检查当前目录是否为 Composer/PHP 项目,依据 composer.json、composer.lock 及 Laravel 等框架包线索判断;若没有 composer.json,则停止并报告当前目录不是 Composer/PHP 项目。
- 运行 composer outdated --direct,列出过期的直接依赖,并按补丁(patch)、次版本(minor)、主版本(major)分组。
- 运行 composer audit,汇总安全公告,并按严重程度分组(在审计输出可用时)。
- 给出建议的安全升级顺序,从低风险的补丁与次版本更新开始。
- 指出主版本升级可能带来的破坏性变更风险、所需代码改动、PHP 版本约束或框架兼容性问题。
- 列出升级后项目应执行的具体验证命令。
使用方式:技能支持以 7 天为周期的循环(loop)方式运行,启动提示为 /loop 7d Start the "Composer Dependency Audit Weekly" loop.;在每轮迭代之间执行 composer outdated --direct || true;当发布含建议升级的摘要后退出。也可在用户提出 Composer 依赖审计、PHP 依赖审查、composer outdated 等需求时直接使用。使用时需在目标项目目录内执行上述命令后整理报告。
适用场景:需要定期巡检 Composer 依赖的 PHP 团队、希望获得升级优先级与风险评估的维护者、需要在升级前了解破坏性变更与验证步骤的开发者。
限制:技能仅生成报告,不会自动应用升级,除非用户明确要求执行升级工作;不得修改检查命令或退出条件来强行成功,不得跳过、禁用或绕过检查使审计结果看起来干净;若包元数据缺失、依赖解析失败,或审计输出因仓库/认证问题受阻,应停止并报告阻塞原因。