Test_Agent/agent/prompt_builder.py
jiawei.chen 6f6053ff51 feat: TestAgent 智能测试平台 v1.0
- 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 合规
2026-07-08 11:27:38 +08:00

188 lines
7.8 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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)