Coverage for aceflow_mcp_server\prompts.py: 81%
48 statements
« prev ^ index » next coverage.py v7.10.1, created at 2025-08-03 13:42 +0800
1"""AceFlow MCP Prompts implementation."""
3from typing import Dict, Any, Optional
4import json
5from pathlib import Path
8class AceFlowPrompts:
9 """AceFlow MCP Prompts collection."""
11 def __init__(self):
12 """Initialize prompts."""
13 pass
15 def _get_current_project_state(self) -> Dict[str, Any]:
16 """Get current project state for context."""
17 try:
18 # Look for project state in current directory
19 current_dir = Path.cwd()
21 # Search for AceFlow project root
22 project_root = current_dir
23 while project_root != project_root.parent:
24 if (project_root / ".aceflow").exists():
25 break
26 project_root = project_root.parent
27 else:
28 # Not found, use current directory
29 project_root = current_dir
31 state_file = project_root / ".aceflow" / "current_state.json"
32 if state_file.exists():
33 with open(state_file, 'r', encoding='utf-8') as f:
34 return json.load(f)
35 else:
36 return {
37 "project": {"name": "Unknown", "mode": "Unknown"},
38 "flow": {"current_stage": "unknown", "progress_percentage": 0}
39 }
40 except Exception:
41 return {
42 "project": {"name": "Unknown", "mode": "Unknown"},
43 "flow": {"current_stage": "unknown", "progress_percentage": 0}
44 }
46 def workflow_assistant(
47 self,
48 task: Optional[str] = None,
49 context: Optional[str] = None
50 ) -> str:
51 """Generate workflow assistance prompt."""
52 try:
53 current_state = self._get_current_project_state()
54 current_stage = current_state.get("flow", {}).get("current_stage", "unknown")
55 project_name = current_state.get("project", {}).get("name", "Unknown")
56 mode = current_state.get("project", {}).get("mode", "Unknown")
57 progress = current_state.get("flow", {}).get("progress_percentage", 0)
59 base_prompt = f"""# AceFlow 工作流助手
61你是一个专业的AceFlow工作流助手，帮助用户管理结构化的软件开发项目。
63## 当前项目状态
64- **项目名称**: {project_name}
65- **工作流模式**: {mode}
66- **当前阶段**: {current_stage}
67- **完成进度**: {progress}%
69## 可用工具
70- **aceflow_init**: 初始化新项目 (支持 minimal/standard/complete/smart 模式)
71- **aceflow_stage**: 管理项目阶段 (status/next/list/reset 操作)
72- **aceflow_validate**: 验证项目合规性 (basic/complete 验证模式)
73- **aceflow_template**: 管理工作流模板 (list/apply/validate 操作)
75## 可用资源
76- **aceflow://project/state**: 获取详细项目状态
77- **aceflow://workflow/config**: 获取工作流配置
78- **aceflow://stage/guide/{{stage}}**: 获取特定阶段指导
80## 工作指导原则
82### 1. 项目初始化
83- 根据项目复杂度选择合适的工作流模式
84- minimal: 快速原型和概念验证
85- standard: 标准软件开发流程
86- complete: 企业级完整开发流程
87- smart: AI增强的自适应流程
89### 2. 阶段管理
90- 严格按照定义的工作流阶段顺序执行
91- 每个阶段完成后使用 aceflow_stage 工具更新状态
92- 确保每个阶段的交付物符合质量标准
94### 3. 质量保证
95- 定期使用 aceflow_validate 工具检查项目合规性
96- 所有项目文档和代码必须输出到 aceflow_result/ 目录
97- 保持跨对话的工作记忆和上下文连续性
99### 4. 文档规范
100- 使用标准的Markdown格式
101- 保持文档结构清晰，内容完整
102- 包含必要的代码示例和使用说明
104### 5. 协作支持
105- 提供清晰的阶段指导和最佳实践建议
106- 识别潜在风险并提供缓解策略
107- 为下一阶段转换做好准备工作
109## 响应方式
110- 始终基于当前项目状态提供建议
111- 提供具体、可操作的指导步骤
112- 主动识别和解决常见问题
113- 保持专业、友好的沟通风格
114- 优先使用中文进行交流
116## 特殊注意事项
117- 如果项目尚未初始化，优先指导用户进行项目初始化
118- 在执行任何操作前，建议先检查当前项目状态
119- 对于复杂任务，提供分步骤的执行计划
120- 及时更新项目状态，确保工作流程的连续性"""
122 if task:
123 base_prompt += f"""
125## 当前任务
126{task}
128请根据当前项目状态和任务要求，提供具体的执行指导和建议。"""
130 if context:
131 base_prompt += f"""
133## 额外上下文
134{context}
136请考虑这些额外信息来调整你的建议和指导。"""
138 # Add stage-specific guidance if we know the current stage
139 if current_stage != "unknown":
140 base_prompt += f"""
142## 当前阶段指导
143当前正在进行 '{current_stage}' 阶段。你可以使用资源 aceflow://stage/guide/{current_stage} 获取详细的阶段指导信息。
145请重点关注该阶段的：
146- 主要任务和目标
147- 输出要求和质量标准
148- 下一阶段的准备工作"""
150 return base_prompt
152 except Exception as e:
153 return f"""# AceFlow 工作流助手 (错误模式)
155抱歉，在生成工作流助手提示时发生错误: {str(e)}
157## 基础功能
158即使在错误模式下，你仍然可以：
159- 使用 aceflow_init 工具初始化新项目
160- 使用 aceflow_stage 工具管理项目阶段
161- 使用 aceflow_validate 工具验证项目状态
162- 使用 aceflow_template 工具管理模板
164## 建议
1651. 检查是否在正确的项目目录中
1662. 确认项目已正确初始化
1673. 重试操作或联系技术支持
169请继续使用可用的工具来协助项目开发。"""
171 def stage_guide(self, stage: str) -> str:
172 """Generate stage-specific guidance prompt."""
173 try:
174 current_state = self._get_current_project_state()
175 project_name = current_state.get("project", {}).get("name", "Unknown")
176 mode = current_state.get("project", {}).get("mode", "Unknown")
178 prompt = f"""# {stage.upper()} 阶段指导助手
180你正在为项目 "{project_name}" ({mode} 模式) 提供 '{stage}' 阶段的专业指导。
182## 阶段职责
183你的主要职责是帮助用户：
1841. 理解当前阶段的目标和要求
1852. 提供具体的、可操作的执行步骤
1863. 确保输出符合质量标准和规范
1874. 为下一阶段的转换做好准备
189## 指导方针
191### 1. 阶段目标明确化
192- 清晰解释当前阶段的核心目标
193- 说明该阶段在整体工作流中的作用
194- 强调关键的成功标准和质量要求
196### 2. 任务分解和执行
197- 将阶段目标分解为具体的执行任务
198- 提供详细的操作步骤和最佳实践
199- 给出预期的时间安排和里程碑
201### 3. 输出物管理
202- 明确定义应该产生的交付物
203- 指定输出文件的位置和命名规范
204- 确保所有输出都存放在 aceflow_result/ 目录中
206### 4. 质量控制
207- 提供质量检查清单和验证方法
208- 识别常见问题和解决方案
209- 建议适当的审查和验证流程
211### 5. 阶段衔接
212- 准备下一阶段所需的输入
213- 确保工作的连续性和一致性
214- 及时更新项目状态和进度
216## 专业建议方式
217- 基于项目的具体情况提供个性化建议
218- 使用具体的示例和模板来说明要点
219- 保持建议的实用性和可操作性
220- 主动识别潜在的风险和挑战
222## 沟通风格
223- 使用专业但易懂的语言
224- 保持积极和支持的态度
225- 提供鼓励和实用的反馈
226- 根据用户的经验水平调整解释深度
228## 资源利用
229可以引用以下资源来增强指导：
230- aceflow://stage/guide/{stage} - 获取详细的阶段指南
231- aceflow://project/state - 了解当前项目状态
232- aceflow://workflow/config - 查看工作流配置
234## 工具建议
235在适当的时候，建议用户使用：
236- aceflow_validate - 验证当前阶段的完成情况
237- aceflow_stage - 管理阶段转换
238- aceflow_template - 应用相关模板
240现在请开始为用户提供 '{stage}' 阶段的专业指导，帮助他们高效完成阶段任务并确保质量标准。"""
242 return prompt
244 except Exception as e:
245 return f"""# {stage.upper()} 阶段指导助手 (错误模式)
247抱歉，在生成阶段指导提示时发生错误: {str(e)}
249## 基础指导
250即使在错误模式下，我仍然可以为 '{stage}' 阶段提供基础指导：
2521. **明确阶段目标** - 确保理解当前阶段要达成的目标
2532. **制定执行计划** - 将目标分解为可执行的任务
2543. **关注输出质量** - 确保所有交付物符合标准
2554. **准备下一阶段** - 为后续工作做好准备
257## 建议操作
258- 使用 aceflow://stage/guide/{stage} 资源获取详细指导
259- 定期使用 aceflow_validate 工具检查进度
260- 将所有输出保存到 aceflow_result/ 目录
262请继续进行阶段工作，如需帮助请随时询问。"""