AIDocxWorkFlow: Skill for Claude Code

AIDocxWorkFlow — 反馈收集与导入 Skill

功能概述

feedback_logger 模块支持从多种来源导入反馈，自动识别 Excel sheet 列名，标准化后保存。

核心函数

import_feedback() — 通用导入

from ai_workflow.feedback_logger import import_feedback

result = import_feedback(
    feedback_file="/path/to/feedback.xlsx",
    review_file="/path/to/review.xlsx",   # 可选
    output_dir="/path/to/feedback_logs/",
    version="v1.0",
    req_name="游戏道具商城系统",
    merge_duplicates="latest",            # "latest" | "first" | "all"
)

import_from_test_cases_xlsx() — 从 test_cases.xlsx 导入

from ai_workflow.feedback_logger import import_from_test_cases_xlsx

# 自动读「反馈结果」或「执行追踪」sheet
result = import_from_test_cases_xlsx(
    xlsx_path="/path/to/test_cases.xlsx",
    version="v1.0",
)

CLI 用法

# 从 Excel 导入（自动探测反馈结果 sheet）
python3 -m ai_workflow.feedback_logger --file feedback.xlsx

# 从 test_cases.xlsx 读执行追踪 sheet
python3 -m ai_workflow.feedback_logger --file test_cases.xlsx

# 同时提供反馈和审查结果
python3 -m ai_workflow.feedback_logger \
    --file feedback.xlsx \
    --review review.xlsx \
    --version v1.0

---

支持的文件格式

Excel 文件

自动探测以下 sheet，按优先级依次查找：

反馈 sheet（import_feedback）：

1. 反馈结果
2. 执行追踪
3. 执行记录
4. 用例详情

审查 sheet（import_feedback --review）：

1. 审核结果
2. 审查结果
3. review

test_cases.xlsx 专属 sheet（import_from_test_cases_xlsx）：

1. 反馈结果
2. 执行追踪 ← test_cases.xlsx 的这个 sheet 就是反馈数据
3. 执行记录

CSV 文件

自动识别 GBK/UTF-8 编码，首行作为列头。

JSON 文件

支持三种格式：

// 格式 1: 顶层数组
[{"case_id": "UI-TC-001", "result": "PASS", ...}]

// 格式 2: 对象含 entries 字段
{"entries": [{"case_id": "...", ...}]}

// 格式 3: 单条记录
{"case_id": "UI-TC-001", "result": "PASS", ...}

---

自动列名映射

模块自动将各种中文/英文列名映射到标准字段：

标准字段	支持的中文列名	支持的英文列名
case_id	用例ID, 用例编号, 测试用例ID	case_id, test_case_id
result	执行结果, 测试结果, 执行状态	result, test_result, status
actual_result	实际结果, 实际输出, 观测结果	actual_result, actual_output
defect_desc	缺陷描述, 问题描述, 缺陷说明	defect_desc, bug_description, issue
severity	严重程度, 缺陷等级	severity, bug_severity, priority
reviewer	审核人, 审核者	reviewer, auditor
review_result	审核结果, 审查结果	review_result, audit_result
module	模块, 所属模块	module
title	用例描述, 用例名称	title, test_title
execution_time	执行时间, 测试时间	execution_time, test_time