Python开发多轮指令编排清晰框架提示词

角色定义与任务定位

请以“指令流程架构师”的身份，运用本方案。你的核心目标是：为复杂的Python应用（如智能助手、对话系统、工作流引擎）设计一个逻辑清晰、可维护、可扩展的多轮指令（Multi-turn Instruction）编排框架。你需要将散乱、线性的对话逻辑，转化为结构化的状态机、规则引擎或决策树模型，确保指令流转的精准与稳定。

适用场景

• 开发需要处理上下文依赖的对话式AI应用。
• 构建涉及多步骤、多条件分支的业务流程自动化脚本。
• 设计用户与系统进行复杂交互（如配置向导、数据查询、故障诊断）的后端逻辑。
• 重构现有冗长且难以维护的if-else嵌套式指令处理代码。

核心提示词

以下提示词可直接用于引导AI生成框架代码或进行详细设计讨论：

• “设计一个基于状态机（State Machine）的Python多轮指令处理框架，包含状态定义、事件触发、上下文存储和状态转移逻辑。”
• “实现一个指令编排器（Orchestrator），能够解析用户输入，根据会话历史（上下文）决定当前应执行的动作或返回的响应，并管理会话状态的生命周期。”
• “编写一个可插拔的规则引擎，用于评估多轮指令中的条件（如：用户意图、实体槽位是否填满、权限校验），并驱动流程进入下一阶段。”
• “构建一个清晰的指令管道（Pipeline），包含输入验证、意图识别、上下文检索、指令执行、响应格式化等环节，支持中间件扩展。”

风格方向

• 代码风格：面向对象设计，模块化程度高，类与职责单一。优先使用枚举类定义指令状态，使用数据类（dataclass）或Pydantic模型管理上下文。
• 架构风格：清晰的分层架构（如表示层、逻辑层、数据层），或采用事件驱动、响应式编程思想来解耦指令处理单元。
• 文档风格：框架应具备自解释性，关键部分需有类型注解和清晰的Docstring。同时，提供流程图或序列图来说明核心指令的流转路径。

构图建议（逻辑结构）

• 顶层构图：采用“中心调度器+多个处理单元”的星形或总线型结构。一个核心的`SessionManager`或`Orchestrator`作为大脑，协调各个`IntentHandler`或`StateHandler`。
• 流程构图：设计为“初始化 -> 接收输入 -> 上下文更新 -> 规则评估 -> 动作执行 -> 状态跃迁 -> 生成输出”的闭环流水线。使用`match-case`语句或策略模式来处理不同的意图分支。
• 数据流构图：确保`Context`对象像一条主线，贯穿整个多轮对话始终，所有处理单元都读取或更新这个共享上下文，避免状态分散。

细节强化

• 上下文管理：实现一个线程安全或协程安全的上下文存储，支持嵌套、过期和序列化。考虑使用`redis`或`SQLite`进行持久化。
• 错误与边界处理：为框架设计统一的超时、重试、回退（fallback）和异常处理机制。例如，当用户指令无法识别时，如何优雅地引导或重置对话。
• 可观测性：集成日志记录，关键状态变更、指令跳转应有迹可循。考虑添加指标（Metrics）收集，如指令处理耗时、各状态停留次数。
• 测试性：框架设计应便于单元测试和集成测试。提供模拟（Mock）上下文和用户输入的工具，方便验证各种指令流转路径。

使用建议

• 在项目初期，先用核心提示词生成基础框架代码，再根据具体业务需求填充具体的状态和处理器。
• 将“指令”和“处理器”进行解耦注册，便于动态加载和扩展，例如使用配置文件或装饰器进行注册。
• 优先保证框架的逻辑清晰度和可调试性，在性能不是瓶颈时，避免过早进行过度优化。
• 在实际应用中，结合`asyncio`实现异步指令处理，以提升高并发场景下的吞吐能力。