ai-test-asset-manager 0.1.0

CLI for AI-assisted test asset governance, duplicate analysis, process modeling, and Codex-native natural language workflows.

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：

• AI Test Asset Manager Skill PRD.md
• BUSINESS_PROCESS_MODEL_DESIGN.md
• PROJECT_WORKSPACE_DESIGN.md