Metadata-Version: 2.4
Name: ai-test-asset-manager
Version: 0.1.0
Summary: CLI for AI-assisted test asset governance, duplicate analysis, process modeling, and Codex-native natural language workflows.
Author-email: Susie <zhn0946@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/Susie946/ai-test-asset-manager-cli
Project-URL: Repository, https://github.com/Susie946/ai-test-asset-manager-cli
Project-URL: Issues, https://github.com/Susie946/ai-test-asset-manager-cli/issues
Keywords: testing,cli,excel,test-case-management,ai,codex
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# AI Test Asset Manager

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

## 推荐使用形态

推荐采用两层结构：

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

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

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

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

## 安装

本地开发安装：

```bash
pip install -e .
```

陌生机器直接安装：

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

安装完成后可执行：

```bash
ai-test-asset-manager --help
test-asset-manager --help
```

## Codex 中如何用

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

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

典型命令会是：

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

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

```bash
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`

## 常用命令

生成标准化资产：

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

生成中文治理报告：

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

导出 Excel：

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

输出统计：

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

搜索案例：

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

生成合并建议：

```bash
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](D:/project/AI%20Test%20Asset%20Manager/docs/requirements)：

- [AI Test Asset Manager Skill PRD.md](D:/project/AI%20Test%20Asset%20Manager/docs/requirements/AI%20Test%20Asset%20Manager%20Skill%20PRD.md)
- [BUSINESS_PROCESS_MODEL_DESIGN.md](D:/project/AI%20Test%20Asset%20Manager/docs/requirements/BUSINESS_PROCESS_MODEL_DESIGN.md)
- [PROJECT_WORKSPACE_DESIGN.md](D:/project/AI%20Test%20Asset%20Manager/docs/requirements/PROJECT_WORKSPACE_DESIGN.md)
