- CLI + Web 双平台,基于 LLM 的 TDD+DDD 自动化测试生成 - 集成 unified-test-platform 903 个 D-Cloud 用例 + 13 个 Robogo 场景 - Agent 5 步流水线: 扫描 -> DDD -> LLM 生成测试 - 精确回归 + UI 变更检查 - 可视化 HTML 测试报告 - 暗色/亮色主题切换 - 19 个 API 端点 + 6 个 SPA 页面 - 15/15 项 TDD+DDD 合规
188 lines
7.8 KiB
Python
188 lines
7.8 KiB
Python
import logging
|
||
from pathlib import Path
|
||
from typing import Optional
|
||
|
||
from agent.code_analyzer import FileAnalysis, ClassInfo, MethodInfo, FunctionInfo
|
||
from agent.domain_extractor import DomainModel, BoundedContext
|
||
|
||
logger = logging.getLogger(__name__)
|
||
|
||
|
||
class PromptBuilder:
|
||
|
||
def __init__(self, skills_dir: Path, soul_path: Path):
|
||
self.skills_dir = Path(skills_dir)
|
||
self.soul_path = Path(soul_path)
|
||
self._soul = self._load_soul()
|
||
self._skills_cache = {}
|
||
|
||
def _load_soul(self) -> str:
|
||
if self.soul_path.exists():
|
||
return self.soul_path.read_text(encoding="utf-8")
|
||
return ""
|
||
|
||
def _load_skill(self, skill_name: str) -> str:
|
||
if skill_name in self._skills_cache:
|
||
return self._skills_cache[skill_name]
|
||
skill_path = self.skills_dir / skill_name / "SKILL.md"
|
||
if skill_path.exists():
|
||
content = skill_path.read_text(encoding="utf-8")
|
||
self._skills_cache[skill_name] = content
|
||
return content
|
||
return ""
|
||
|
||
def build_system_prompt(self, domain_model: Optional[DomainModel] = None) -> str:
|
||
parts = [self._soul]
|
||
|
||
tdd_skill = self._load_skill("tdd-methodology")
|
||
if tdd_skill:
|
||
parts.append(f"\n## TDD 方法论\n{tdd_skill}")
|
||
|
||
ddd_skill = self._load_skill("ddd-patterns")
|
||
if ddd_skill:
|
||
parts.append(f"\n## DDD 模式\n{ddd_skill}")
|
||
|
||
test_fw_skill = self._load_skill("test-framework")
|
||
if test_fw_skill:
|
||
parts.append(f"\n## 测试框架规范\n{test_fw_skill}")
|
||
|
||
if domain_model and domain_model.bounded_contexts:
|
||
parts.append("\n## 当前项目的领域模型\n")
|
||
parts.append("请按以下限界上下文组织测试代码:\n")
|
||
for ctx in domain_model.bounded_contexts:
|
||
parts.append(f"### {ctx.name}")
|
||
parts.append(f"- 聚合根: {', '.join(ctx.aggregate_roots) if ctx.aggregate_roots else '无'}")
|
||
parts.append(f"- 实体: {', '.join(ctx.entities) if ctx.entities else '无'}")
|
||
parts.append(f"- 领域服务: {', '.join(ctx.domain_services) if ctx.domain_services else '无'}")
|
||
parts.append(f"- 仓储: {', '.join(ctx.repositories) if ctx.repositories else '无'}")
|
||
parts.append("")
|
||
|
||
if domain_model.ubiquitous_language:
|
||
parts.append("## 统一语言(术语表)\n")
|
||
for term, definition in list(domain_model.ubiquitous_language.items())[:30]:
|
||
parts.append(f"- **{term}**: {definition}")
|
||
|
||
return "\n\n".join(parts)
|
||
|
||
def build_file_context(self, analysis: FileAnalysis, source_code: str = "") -> str:
|
||
parts = [f"## 文件: {analysis.path}"]
|
||
parts.append(f"语言: {analysis.language}")
|
||
parts.append(f"行数: {analysis.line_count}")
|
||
|
||
if analysis.docstring:
|
||
parts.append(f"\n模块文档:\n{analysis.docstring}")
|
||
|
||
if analysis.imports:
|
||
parts.append(f"\n依赖导入:")
|
||
for imp in analysis.imports[:20]:
|
||
if imp.is_from_import:
|
||
parts.append(f" from {imp.module} import {', '.join(imp.names)}")
|
||
else:
|
||
parts.append(f" import {imp.module}")
|
||
|
||
if analysis.classes:
|
||
parts.append(f"\n类定义 ({len(analysis.classes)} 个):")
|
||
for cls in analysis.classes:
|
||
parts.append(self._format_class(cls))
|
||
|
||
if analysis.functions:
|
||
parts.append(f"\n函数定义 ({len(analysis.functions)} 个):")
|
||
for func in analysis.functions:
|
||
parts.append(self._format_function(func))
|
||
|
||
if source_code:
|
||
parts.append(f"\n源代码:\n```{analysis.language}\n{source_code}\n```")
|
||
|
||
return "\n".join(parts)
|
||
|
||
def _format_class(self, cls: ClassInfo) -> str:
|
||
parts = [f"\n 类: {cls.name}"]
|
||
if cls.base_classes:
|
||
parts.append(f" 继承: {', '.join(cls.base_classes)}")
|
||
if cls.decorators:
|
||
parts.append(f" 装饰器: {', '.join(cls.decorators)}")
|
||
if cls.docstring:
|
||
doc_short = cls.docstring.split("\n")[0][:100]
|
||
parts.append(f" 文档: {doc_short}")
|
||
if cls.is_abstract:
|
||
parts.append(" 抽象类: 是")
|
||
if cls.is_dataclass:
|
||
parts.append(" 数据类: 是")
|
||
if cls.methods:
|
||
parts.append(f" 方法 ({len(cls.methods)} 个):")
|
||
for m in cls.methods:
|
||
parts.append(f" - {m.name}({', '.join(m.args[:5])})")
|
||
if m.return_type:
|
||
parts[-1] += f" -> {m.return_type}"
|
||
if m.docstring:
|
||
doc_short = m.docstring.split("\n")[0][:80]
|
||
parts.append(f" {doc_short}")
|
||
return "\n".join(parts)
|
||
|
||
def _format_function(self, func: FunctionInfo) -> str:
|
||
parts = [f"\n 函数: {func.name}({', '.join(func.args[:5])})"]
|
||
if func.return_type:
|
||
parts[-1] += f" -> {func.return_type}"
|
||
if func.decorators:
|
||
parts.append(f" 装饰器: {', '.join(func.decorators)}")
|
||
if func.docstring:
|
||
doc_short = func.docstring.split("\n")[0][:100]
|
||
parts.append(f" 文档: {doc_short}")
|
||
if func.is_async:
|
||
parts.append(" 异步: 是")
|
||
return "\n".join(parts)
|
||
|
||
def build_test_generation_prompt(
|
||
self,
|
||
file_analysis: FileAnalysis,
|
||
source_code: str,
|
||
domain_model: DomainModel,
|
||
test_type: str = "unit",
|
||
) -> str:
|
||
file_context = self.build_file_context(file_analysis, source_code)
|
||
|
||
context_name = "shared_kernel"
|
||
for ctx in domain_model.bounded_contexts:
|
||
if file_analysis.path in ctx.files:
|
||
context_name = ctx.name
|
||
break
|
||
|
||
test_type_desc = {
|
||
"unit": "单元测试:测试单个函数/方法的逻辑,隔离所有外部依赖(数据库/网络/文件系统),使用 Mock/Stub",
|
||
"integration": "集成测试:测试跨模块/跨服务的接口联动,验证数据传递和参数透传",
|
||
"smoke": "冒烟测试:核心主流程快速验证,只覆盖最关键的 happy path",
|
||
"e2e": "端到端测试:完整业务流程黑盒验证,覆盖功能/边界/异常/兼容性",
|
||
"session": "Session 领域测试:测试 session 创建、历史持久化、上下文携带、历史清除、销毁",
|
||
}
|
||
|
||
prompt_parts = [
|
||
f"请为以下代码生成 {test_type_desc.get(test_type, test_type)}",
|
||
f"",
|
||
f"## 限界上下文: {context_name}",
|
||
f"",
|
||
file_context,
|
||
f"",
|
||
"## 生成要求",
|
||
"",
|
||
"1. 使用 pytest 框架",
|
||
"2. 测试函数命名遵循 `test_should_<预期行为>_when_<条件>` 模式",
|
||
"3. 每个测试函数必须有清晰的 docstring 描述测试意图",
|
||
"4. 遵循 AAA 模式(Arrange-Act-Assert)",
|
||
"5. 使用 `@pytest.mark.{test_type}` 标记测试类型",
|
||
"6. 对领域层测试,隔离所有基础设施依赖(使用 Mock)",
|
||
"7. 对基础设施层测试,可以使用真实依赖",
|
||
"8. 测试目录结构: tests/{domain_layer|infrastructure}/{context_name}/",
|
||
"9. 只生成测试代码,用 ```python 包裹,不要生成其他内容",
|
||
"10. 代码必须可直接运行,不得有 TODO 或占位符",
|
||
"",
|
||
"## 输出格式",
|
||
"",
|
||
"请按以下格式输出(每个测试文件一个代码块):",
|
||
"",
|
||
"```python",
|
||
"# tests/domain/{context_name}/test_{module_name}.py",
|
||
"实际测试代码...",
|
||
"```",
|
||
]
|
||
|
||
return "\n".join(prompt_parts) |