项目开发的提示词
重要工具清单
1) 任务管理
任务管理工具提供后台任务的全生命周期控制能力,覆盖从创建、查询、更新、监控到停止的完整链路。
| 工具名称 | readOnly | destructive | concurrencySafe | 简要说明 |
|---|---|---|---|---|
| TaskCreateTool | false | false | false | 创建后台任务(条件启用:Todo V2) |
| TaskGetTool | true | false | true | 获取单个任务详情 |
| TaskUpdateTool | false | false | false | 更新任务状态或内容 |
| TaskListTool | true | false | true | 列出所有任务 |
| TaskOutputTool | 动态 | false | 动态 | 获取任务输出流;当 readOnly 时,concurrencySafe 为 true |
| TaskStopTool | false | false | true | 停止正在运行的任务 |
典型工作流
- 使用
TaskCreateTool创建任务。 - 使用
TaskListTool查看整体进度。 - 使用
TaskGetTool检查单任务详情。 - 使用
TaskOutputTool持续获取输出日志。 - 需要中断时,使用
TaskStopTool停止任务。
2) 计划
计划模式工具用于“先规划、后执行”,在复杂变更前提供更安全的分析与决策路径。
| 工具名称 | readOnly | destructive | concurrencySafe | 简要说明 |
|---|---|---|---|---|
| EnterPlanModeTool | true | false | true | 进入计划模式,仅允许使用只读工具集 |
| ExitPlanModeV2Tool | true | false | true | 退出计划模式,恢复正常工具权限 |
使用场景
计划模式是一种安全策略:进入后,智能体只能使用只读工具(如 FileReadTool、GrepTool)进行信息收集与分析,不能执行任何修改操作。该模式适用于复杂需求前的方案设计、风险评估与影响分析。可结合第 14 章“结构化工作流”使用。
3) 用户澄清
当需求不完整、存在多种实现分支,或继续执行可能引发误操作时,应优先通过提问与用户确认。
| 工具名称 | readOnly | destructive | concurrencySafe | 简要说明 |
|---|---|---|---|---|
| AskUserQuestionTool | true | false | true | 向用户发起澄清问题,获取关键决策后再继续执行 |
推荐触发时机
- 需求存在歧义(如目标、范围、优先级不明确)。
- 需要用户在多个方案中做选择(如性能优先 vs. 可维护性优先)。
- 涉及潜在破坏性操作前(如删除数据、批量覆盖、重构核心路径)。
- 发现上下文缺失(如缺少环境变量、账号权限、外部依赖信息)。
按计划开发连续工作提示词
用于“先计划、再连续执行”的场景,减少来回确认成本。
基础版(通用)
|
|
增强版(含质量约束)
|
|
配套执行规范
- 每轮输出包含:当前步骤、完成情况、下一步。
- 对未解决问题给出:影响范围、候选方案、推荐方案。
- 涉及数据库/配置/权限变更时,必须先确认再执行。
从零到一项目开发
适用于新项目冷启动,目标是从“想法”快速推进到“可运行 MVP”。
推荐流程
- 需求澄清:目标用户、核心场景、验收标准。
- 技术选型:框架、数据存储、部署方式、成本约束。
- 架构设计:模块划分、接口边界、目录结构。
- 里程碑拆分:MVP → Beta → 正式版。
- 实现与验证:按优先级逐步交付并测试。
可复用提示词
|
|
|
|
新增功能需求开发
适用于已有项目中的增量需求,重点是“兼容存量、控制影响面”。
标准步骤
- 阅读相关模块,确认现有实现模式。
- 明确需求边界与非目标。
- 设计最小改动方案(接口、数据、UI/交互)。
- 先补测试或验收用例,再实现。
- 回归验证并输出变更说明。
可复用提示词
|
|
代码重构与优化
Bug 修复
修复策略强调“先复现、再定位、后修复、再验证”。
可复用提示词
|
|