SuperAPI AI 工具集

lifecycle-method

编程与开发

查看项目

更新于 10-15 09:52

技能介绍

用途

lifecycle-method 用于协调完整的 AI 开发工作,覆盖代码、测试、项目知识与产物。它拥有所请求的结果及其后果,并让工作与风险、范围和授权成比例。该技能负责决策与调度,而不是第二套专业检测提示。

主要能力

  • 支持 assess、repair、change、verify、consolidate 等操作,并可通过 native-reports 进行原生报告转换。
  • 通过 project-protocol:project-protocol 技能管理运行记录、快照、验证与恢复。
  • 使用 run_state.py 辅助工具进行初始化、查看、验证、更新与恢复运行状态。
  • 根据需求加载或调度多种方法,包括静态上下文分析、候选正确性审查、评估来源整合、应用清理、测试准备与修复、测试编写、结构诊断、持久指令、指南/文档准备、README 编写、工作区检测与可逆应用、可读性改进以及通用开发规划与执行。
  • 默认评估深度为 quick,一轮初始审计,最多选择五个 worker(包括来自复用方法的文档 worker)。
  • 支持 --depth standard 和 --depth deep 以扩大证据范围或请求全面工作。
  • 支持 --fix 授权范围内编辑,--commit 额外授权提交;两者均不单独授权推送或永久删除产物。

使用方式

  1. 首先加载 project-protocol:project-protocol 技能。
  2. 通过该技能使用已安装的 project-protocol run_state.py 辅助工具。其 CLI 包括:
    • init --project ROOT --payload INPUT.json [--run-id ID] [--out INTERNAL_ROOT]
    • show 或 validate --project ROOT --run-id ID [--out INTERNAL_ROOT]
    • update --project ROOT --run-id ID --expected-revision N --payload PATCH.json
    • resume --project ROOT --run-id ID --payload CONTEXT.json [--out INTERNAL_ROOT]
  3. 初始化 payload 包含 operation、objective、scope {paths, focus}、authorizations、budget、phases、plan、deliveries 和 required_gates。
  4. 在运行内保存权威的 work.json。
  5. 恢复时提供当前授权,并验证确切的运行、工作区、范围和快照。
  6. 在调度前展示范围、选定维度、可能的高成本步骤与缺口。
  7. 根据操作读取对应的参考文件:
    • assess: ${CLAUDE_PLUGIN_ROOT}/skills/lifecycle-method/references/assess.md
    • repair: ${CLAUDE_PLUGIN_ROOT}/skills/lifecycle-method/references/repair.md
    • change: ${CLAUDE_PLUGIN_ROOT}/skills/lifecycle-method/references/change.md
    • verify: ${CLAUDE_PLUGIN_ROOT}/skills/lifecycle-method/references/verify.md
    • consolidate: ${CLAUDE_PLUGIN_ROOT}/skills/lifecycle-method/references/consolidate.md
    • native-reports: ${CLAUDE_PLUGIN_ROOT}/skills/lifecycle-method/references/native-reports.md
  8. 使用 run_state.py validate --project ROOT --run-id ID --result RESULT_PATH 验证最终结果。

适用场景

  • 需要跨代码、测试、项目知识与产物协调完整 AI 开发工作的项目。
  • 需要评估、修复、变更、验证或整合项目生命周期的场景。
  • 需要静态上下文分析、候选正确性审查、测试套件操作、结构诊断、可读性改进等专业方法支持的场景。
  • 需要管理工作区、准备文档或 README、编写持久指令的场景。

限制

  • 预览是 assess/repair/retention 的默认模式。
  • --fix 授权范围内编辑,--commit 额外授权提交;两者均不单独授权推送或永久删除产物。
  • 默认评估深度为 quick,一轮初始审计,最多五个 worker。广泛焦点不会绕过该上限。
  • 必须声明未检查的维度,并在需要时提供更大且明确选择的深度。
  • 提示预算是指令;不要声称宿主强制 token 数。未知消耗即未知。
  • 仅在角色版本、输入指纹、范围和依赖仍然有效时复用交付物。
  • X-ray 是唯一声明的 workflow-in-context 例外。不要递归启动生命周期工作流,也不要假装 TOML invoke 执行工作流。
  • 模式有效意味着结构有效。缺失证据不会变成空的未发现问题结果。缺失交付物仍然缺失。
  • 不要从源代码检查声称运行时覆盖,不要从通过的自生成测试声称正确性,不要从隔离移动声称磁盘恢复。
  • 报告需分别包含请求/读取/运行时执行的覆盖范围、检查及其确切候选快照、决策、变更、剩余限制和下一步行动。整合需添加移动字节数和删除字节数。
  • 新增的强制门需在执行前添加到仅追加的 required_gates 列表;永远不要移除失败的门。