SuperAPI AI 工具集

doc-sectest

安全与审计

查看项目

更新于 10-16 06:06

技能介绍

用途

doc-sectest 用于创建安全测试规范(SECTEST)文档。SECTEST 是 Layer 10 TSPEC 的子类型工件,子类型代码为 45,命名格式为 TSPEC.NN.45.SS。其核心目标是对安全控制和威胁进行验证,覆盖认证(AuthN)、授权(AuthZ)、输入(Input)、加密(Crypto)、配置(Config)和会话(Session)六个类别。

主要能力

该技能用于创建或编辑仅涉及 SECTEST 的工件,以 @sec 和 @spec 约束为主要约束,威胁场景与安全控制验证为核心目标。

SECTEST 遵循 6 段式契约结构:

  1. 文档控制(Document Control)
  2. 测试范围(Test Scope)
  3. 测试用例索引(Test Case Index)
  4. 测试用例详情(Test Case Details)
  5. 安全覆盖矩阵(Security Coverage Matrix)
  6. 可追溯性(Traceability)

必需标签包括累积的 Layer-10 标签:@brd、@prd、@ears、@bdd、@adr、@sys、@req、@spec(若存在则加 @ctr);类型专属必需标签为 @sec 和 @spec。

必需类别为:[AuthN]、[AuthZ]、[Input]、[Crypto]、[Config]、[Session]。TASKS-Ready 阈值为 >=90%,安全覆盖目标与模板对齐(基线 >=90%)。

使用方式

在使用前,需先阅读以下规范参考:

  • ai_dev_ssd_flow/10_TSPEC/SECTEST/SECTEST-MVP-TEMPLATE.md
  • ai_dev_ssd_flow/10_TSPEC/SECTEST/SECTEST-MVP-TEMPLATE.yaml
  • ai_dev_ssd_flow/10_TSPEC/SECTEST/SECTEST_MVP_SCHEMA.yaml

文件夹规则:采用嵌套文件夹结构 docs/10_TSPEC/SECTEST/SECTEST-NN_{slug}/SECTEST-NN_{slug}.md。

验证命令:

SECTEST subtype validation

python ai_dev_ssd_flow/10_TSPEC/scripts/validate_sectest.py docs/10_TSPEC/SECTEST/

Layer-wide TSPEC validation

bash ai_dev_ssd_flow/10_TSPEC/scripts/validate_all_tspec.sh docs/10_TSPEC/

Quality score validation

bash ai_dev_ssd_flow/10_TSPEC/scripts/validate_tspec_quality_score.sh docs/10_TSPEC/

Cross-document validation

python ai_dev_ssd_flow/scripts/validate_cross_document.py --document docs/10_TSPEC/SECTEST/SECTEST-NN_slug/SECTEST-NN_slug.md --auto-fix

Cumulative tag validation

python ai_dev_ssd_flow/scripts/validate_tags_against_docs.py --artifact SECTEST-NN --expected-layers brd,prd,ears,bdd,adr,sys,req,spec --strict

适用场景

适用于创建或编辑仅涉及 SECTEST 的工件,且 @sec 与 @spec 约束为主要约束、威胁场景与安全控制验证为核心目标的情况。

当需要多子类型编排(UTEST/ITEST/STEST/FTEST/PTEST/SECTEST),或以跨子类型规范化、批量 TSPEC 工作为主时,应改用 doc-tspec。

限制

安全规则要求:安全测试必须仅在隔离环境中运行,绝不可对生产系统运行安全测试。

输出质量门禁要求:无 schema/结构阻塞项;所有必需的 SECTEST 段落齐备;@sec 与 @spec 映射明确;威胁场景与安全控制得到体现;可追溯性包含必需的累积标签;安全警告存在且明确;报告引用在适用处使用带版本的命名。

相关技能包括 doc-sectest-autopilot、doc-sectest-validator、doc-sectest-reviewer、doc-sectest-fixer、doc-sectest-audit 以及 doc-tspec(多子类型回退路径)。

版本历史

版本 1.0,日期 2026-02-27,初始 SECTEST 编写技能,对齐规范 SECTEST MVP 模板/规则/schema,并包含安全约束与 TSPEC 共存路由。