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)