SuperAPI AI 工具集

phoenix-batch-planner

安全与审计

查看项目

更新于 10-16 06:03

技能介绍

用途

Phoenix Security — Batch Planner(Role 09)是 Phoenix Security 规范流水线中的一个规划角色,用于把一项 Phoenix Security 功能切分为安全、可增量推进的批次。其目标批次规模为 1–3 工程师日,面向 12 人团队。

该角色依赖 Roles 04、06、07、08,即 REQUIREMENTS、SECURITY、CONTRACTS、VERIFICATION MATRIX;其输出为 09-batch-plan.md 以及 {slug}-cursor-plan.md 中的一节,并传递给 Role 10 — Final Gate。

主要能力

  • 按团队约束进行批次切分:团队规模 12 人,批次目标 1–3 工程师日。
  • 遵循不可协商的批次排序规则:
    • 安全优先:P0 R-SEC-* + PSC-03 + PSC-06 必须位于 Batch 1。
    • 契约先于消费者:类型与 API 契约先于任何消费者实现。
    • 集成最后:外部工具连接器在核心逻辑稳定之后。
    • 推进前先验证:每个批次以验证矩阵中的二元“done-when”结束。
    • 不可逆步骤:数据库迁移、模式变更、租户数据写入需显式标记。
    • AI 门禁:任何触及 LLM 组件的批次在合并前需要人工评审签核。
    • 被阻塞批次:依赖未决问题时标记为 BLOCKED 并附 Q-ID。
  • 按标准批次序列组织工作:
    1. 认证 + 租户隔离 + 数据模型 + 安全基础
    2. 核心 API 契约 + 共享类型 + 错误分类
    3. 核心功能逻辑(happy path)
    4. 集成摄取(工具连接器)
    5. 边界情况 + 错误处理 + 速率限制
    6. 性能验证 + 负载测试
    7. UX/DX 打磨 + 文档 + Cursor 计划交接
  • 生成结构化输出:包含 meta 元数据(角色、会话 ID、token 数、批次数、被阻塞批次数、P0 需求是否在 Batch 1、状态、下一角色)以及 BATCH_PLAN 各批次详情(目标、范围、覆盖需求、步骤、验证、完成条件、可逆性、AI 门禁、阻塞项、风险、指派提示)。
  • 生成 CURSOR_PLAN_SUMMARY,用于 .cursor/plans/ 交接,按批次列出涉及文件、需求、步骤与完成条件。

使用方式

该角色作为 Phoenix Security 规范流水线的一环运行,依赖前序角色输出,并向下游角色传递结果。保存路径为 outputs/{session-id}/09-batch-plan.md,随后传递给 phoenix-final-gate(Role 10)。

输出 schema 包含 meta 段与 BATCH_PLAN 段,每个批次按固定字段填写;CURSOR_PLAN_SUMMARY 段直接供 .cursor/plans/{slug}.md 使用。

适用场景

适用于 Phoenix Security 功能在 12 人团队下的增量交付规划,尤其是需要将安全要求前置、契约先行、集成后置、并逐批验证的工程流程。

限制

  • Token 预算 ≤1200 tokens。
  • 默认技术栈为 Python/Flask · N8N · GCP (AI) · AWS (core)。
  • 架构决策由 @Alfonso Eusebio (CTO) 负责,产品签核由 @Francesco Cipollone (CEO) 负责。
  • CI/CD 为 GitHub Actions + Jenkins。
  • 其他未在资料中说明的功能、收费、价格、平台或效果暂未提供。