SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场doc-ptest-autopilot

doc-ptest-autopilot

测试与质量

查看项目

更新于 10-16 07:00

技能介绍

用途

doc-ptest-autopilot 用于自动化 PTEST 生命周期，面向子类型专属工作流，主要完成三件事：

  • 从上游上下文生成 PTEST；
  • 校验与审计输出；
  • 在需要时移交给修复器（fixer）。

输入契约（IPLAN-004 标准）

支持的模式：

  • --ref <path>
  • --prompt "<text>"
  • --iplan <path|IPLAN-NNN>

优先级：--iplan > --ref > --prompt

IPLAN 解析顺序：

  1. 当显式文件路径存在时使用该路径；
  2. 解析 work_plans/IPLAN-NNN*.md；
  3. 解析 governance/plans/IPLAN-NNN*.md；
  4. 若存在多个匹配项，则失败并要求消歧。

合并冲突规则：主来源与补充来源之间的目标/范围冲突属于阻断性问题，需要用户澄清。

执行模式

生成/查找模式：

  • 输入 PTEST-NN（自身类型）：审查现有文档；
  • 输入 SYS-NN 或 SPEC-NN：若缺失则生成，否则审查现有 PTEST-NN。

审计/修复模式：

  • 运行 doc-ptest-audit；
  • 若失败或低于阈值，运行 doc-ptest-fixer；
  • 重新运行审计，直至通过或达到最大迭代次数。

编排流程

  1. 解析目标 PTEST 文档；
  2. 生成或加载 PTEST；
  3. 运行 doc-ptest-audit；
  4. 如需要，运行 doc-ptest-fixer；
  5. 重新审计；
  6. 输出状态与下一步建议。

命名与契约规则

  • 主要审计输出：PTEST-NN.A_audit_report_vNNN.md
  • 兼容旧版的审查输出：PTEST-NN.R_review_report_vNNN.md
  • 修复报告：PTEST-NN.F_fix_report_vNNN.md

所有报告均存储在父 PTEST 同级的嵌套文件夹中。

文档类型契约（强制）

生成 PTEST 文档实例时，autopilot 必须：

从模板读取 instance_document_type：

  • 来源：ai_dev_ssd_flow/10_TSPEC/PTEST/PTEST-MVP-TEMPLATE.yaml
  • 字段：metadata.instance_document_type: "ptest-document"

在生成文档的 frontmatter 中设置 document_type：

custom_fields: document_type: ptest-document # NOT "template" artifact_type: PTEST layer: 10 test_type_code: 44

校验规则：生成的文档必须具有 document_type: ptest-document；模板具有 document_type: template；实例具有 document_type: ptest-document；schema 对两者均进行校验。

错误处理：若模板中缺少 instance_document_type，则默认使用 ptest-document。

规范引用

  • ai_dev_ssd_flow/10_TSPEC/PTEST/PTEST-MVP-TEMPLATE.md
  • ai_dev_ssd_flow/10_TSPEC/PTEST/PTEST_MVP_SCHEMA.yaml
  • ai_dev_ssd_flow/10_TSPEC/scripts/validate_ptest.py

与 doc-tspec-autopilot 的共存规则

  • 当仅需要 PTEST 范围时，使用 doc-ptest-autopilot；
  • 当需要跨子类型编排时，路由到 doc-tspec-autopilot；
  • 回退：若未解决的子类型阻断问题持续存在，则升级到 doc-tspec-autopilot，同时保持报告兼容性（优先 .A_，兼容旧版 .R_）。

示例调用

  • /doc-ptest-autopilot PTEST-01
  • /doc-ptest-autopilot SYS-01
  • /doc-ptest-autopilot SPEC-01

质量门禁

满足以下条件时通过：

  • PTEST 结构符合 6 段式契约；
  • 必需标签完整；
  • 性能类别与阈值得到体现；
  • 审计状态为 PASS 且分数达到配置阈值。

相关技能

  • doc-ptest
  • doc-ptest-validator
  • doc-ptest-reviewer
  • doc-ptest-fixer
  • doc-ptest-audit
  • doc-tspec-autopilot（混合子类型工作流的回退）

版本历史

版本 1.0，日期 2026-02-27：初始 PTEST autopilot 技能，包含生成/查找加审计-修复编排、带版本的报告契约，以及 TSPEC 共存路由。