Skip to main content

AI Test Asset Manager

AI Test Asset Manager 是一个面向测试案例资产治理的本地 CLI。它的目标不是让用户手工维护零散 Excel,而是把测试案例沉淀成可复用、可追溯、可被大模型稳定调用的资产能力。

推荐使用形态

推荐采用两层结构:

  1. 先安装 ai-test-asset-manager CLI
  2. 再在 Codex 中用自然语言调用它

也就是说,用户在 Codex 里不需要理解复杂命令,只需要说:

  • “帮我分析这个 Excel,生成中文治理报告”
  • “帮我找出疑似重复案例”
  • “请给我重复案例的合并建议”
  • “帮我把这批案例导入项目”
  • “基于当前流程模型评审这批新案例”

Codex 负责把自然语言映射成 CLI 调用,CLI 负责执行稳定的业务规则并自动生成产物。

安装

本地开发安装:

pip install -e .

陌生机器直接安装:

pip install git+https://github.com/Susie946/ai-test-asset-manager-cli.git

安装完成后可执行:

ai-test-asset-manager --help
test-asset-manager --help

Codex 中如何用

如果目标是在 Codex 中自然语言使用,推荐模式是:

  • 用户先安装 CLI
  • 在 Codex 中上传 Excel
  • 直接用中文描述需求
  • Codex 调用 CLI 完成处理

典型命令会是:

ai-test-asset-manager ask "帮我生成测试资产治理报告" --input "./测试案例Example.xlsx" --output-dir "./outputs"

如果要进入项目工作区门禁流程:

ai-test-asset-manager ask "帮我导入这批案例" --input "./测试案例Example.xlsx" --workspace "./workspace" --output-dir "./chat-outputs"
ai-test-asset-manager ask "加入已有项目 demo-project" --workspace "./workspace" --pending-id "<pending-id>" --project-id "demo-project" --output-dir "./chat-outputs"

基础管理能力

  • Excel 导入与标准化沉淀
  • 多 sheet 导入与导出
  • Excel 案例导出
  • 案例搜索
  • 模块规范化
  • 统计信息汇总
  • 一键处理流程
  • 项目级工作区管理

对应 CLI:

  • ingest
  • report
  • export
  • summary
  • search
  • normalize-module
  • process
  • project init
  • project prepare-import
  • project confirm-import
  • project import
  • project status

AI 辅助能力

  • 严格重复识别
  • 疑似重复识别
  • 疑似重复案例 A / B 对比
  • 合并建议生成
  • 合并草案应用
  • 中文治理报告生成
  • 自然语言调用
  • 执行记录与审计追溯

对应 CLI:

  • merge-draft
  • merge-apply
  • ask

业务流程模型能力

首次导入案例后,工具可以自动生成业务流程模型基线,不再只从“模块”视角管理案例,而是开始从“业务流程”视角评审测试设计。

自动产物包括:

  • business-process-index.json
  • business-process-<domain>.json
  • business-process-<domain>.md
  • case-process-mapping-<batch>.json

增量能力包括:

  • 把新案例映射到已有流程模型
  • 分析已覆盖节点、未覆盖节点、未覆盖连接
  • 分析异常分支、补偿流程、回滚流程缺口
  • 先生成 change set,再决定是否应用到正式模型

对应 CLI:

  • process-model rebuild
  • process-model review
  • process-model apply-changes

安全规则:

  • 新 Excel 默认按增量批次处理
  • 未在本批次提及的历史分支不能被自动删除
  • 流程变更先进入 change set,再由用户确认

项目工作区模式

为了解决一个人管理多个项目、一个项目多轮案例迭代、每次操作都需要留痕的问题,CLI 提供 workspace / project / batch 三层结构。

工具会自动维护:

  • assets/current-assets.json
  • assets/snapshots/
  • process-model/current/
  • process-model/snapshots/
  • reports/
  • batches/<batch-id>/
  • batches/<batch-id>/manifest.json

项目归属规则:

  • 上传案例后,不直接入库
  • 必须先确认是“加入已有项目”还是“新建项目”
  • 确认前文件只进入 .pending-imports/
  • 确认后才创建正式 batch,并更新 current

聊天态标准字段:

  • interaction_stage
  • project_assignment
  • projects
  • next_actions

常用命令

生成标准化资产:

ai-test-asset-manager ingest "./测试案例Example.xlsx" --sheet all --asset-json "./outputs/assets.json"

生成中文治理报告:

ai-test-asset-manager report --asset-json "./outputs/assets.json" --output "./outputs/governance-report.md"

导出 Excel:

ai-test-asset-manager export --asset-json "./outputs/assets.json" --output "./outputs/normalized-export.xlsx" --sheet all

输出统计:

ai-test-asset-manager summary --asset-json "./outputs/assets.json"

搜索案例:

ai-test-asset-manager search --asset-json "./outputs/assets.json" --query "邀请好友" --sheet all --limit 20

生成合并建议:

ai-test-asset-manager merge-draft --asset-json "./outputs/assets.json"

主要产出物

  • 标准化资产 JSON
  • 中文治理报告 Markdown
  • 标准化导出 Excel
  • 搜索结果 JSON / Markdown
  • 统计摘要 JSON / Markdown
  • 模块规范化映射 JSON
  • 模块规范化预览 Markdown
  • 规范化后的资产 JSON
  • 业务流程索引 JSON
  • 单流程域模型 JSON
  • 单流程域报告 Markdown
  • 案例流程映射 JSON
  • 流程 change set JSON
  • 流程评审报告 Markdown
  • 项目 registry JSON
  • batch manifest JSON
  • 合并后资产 JSON
  • 合并审计报告 Markdown
  • 自然语言执行记录 JSON
  • 自然语言执行摘要 Markdown

文档

设计文档位于 docs/requirements:

Metadata

Release files for ai-test-asset-manager 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ai-test-asset-manager 0.1.0
File Size Uploaded Provenance Actions
ai_test_asset_manager-0.1.0.tar.gz 47.7 kB Without provenance Details for ai_test_asset_manager-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ai-test-asset-manager 0.1.0
File Interpreter ABI Platform Actions
ai_test_asset_manager-0.1.0-py3-none-any.whl Python 3 none any Details for ai_test_asset_manager-0.1.0-py3-none-any.whl

Total release size: 89.4 kB

Release files / ai_test_asset_manager-0.1.0.tar.gz

Download URL ai_test_asset_manager-0.1.0.tar.gz
Size 47.7 kB
Tags Source
SHA-256 checksum
How to use checksums
d208ed3dc56fedf997b82eec4efe63a6b8986085e79ce9323c03be353606d977
BLAKE2b-256 checksum
How to use checksums
712b4267d7dc80a21790695c54c1cdfec0002999711ee63482025b254453e8f3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.9

Release files / ai_test_asset_manager-0.1.0-py3-none-any.whl

Download URL ai_test_asset_manager-0.1.0-py3-none-any.whl
Size 41.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5c87a27b9796d6b9223332e0ab13e5f7689f66adf49a1b64f4cf11d0e3b15a3a
BLAKE2b-256 checksum
How to use checksums
885d7279009999f20a9451cdb98c76eb34c6e136b51ddb900a7b50befd4a6a71
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.9

Security for ai-test-asset-manager 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page