Skip to content

feat(user-guide): 计划确认 + 执行监控扩展三入口与任务清单(双语)#13

Merged
yi-ge merged 2 commits into
mainfrom
docs/plan-tasks-feature
May 17, 2026
Merged

feat(user-guide): 计划确认 + 执行监控扩展三入口与任务清单(双语)#13
yi-ge merged 2 commits into
mainfrom
docs/plan-tasks-feature

Conversation

@yi-ge
Copy link
Copy Markdown
Member

@yi-ge yi-ge commented May 17, 2026

Summary

补齐 v10.0.x 引入的 Plan 模式与 Task 清单的客户向说明(中英双语同步)。

「计划确认」章节扩展(04-delegation/02-plan-confirmation.md

  • 新增「智能体什么时候会主动制定计划」表,明确自动触发 / 不触发条件
  • 新增「主动要求先做计划」一节,介绍三种显式开启入口:
    • 📋 toggle 按钮(含视觉提示)
    • Shift + Tab 快捷键
    • /plan 斜杠命令(两种用法)
  • 新增「强制模式与自动判断的区别」对比表
  • 新增「审批的三个选项」(批准 / 修改 / 拒绝,含强制模式审批后自动退出)
  • 新增「计划文件的位置」一节:每个智能体工作目录下的 plans/ 子文件夹 + 计划文件六大标准章节(Context / Steps / Critical Files / Artifacts / Verification / Risks & Rollback)

「执行监控」章节扩展(04-delegation/03-execution-monitoring.md

  • 步骤状态加 🔹 待办 / 🗑️ 已放弃
  • 新增「任务清单」大节,覆盖:清单样子、状态立即更新纪律、依赖关系(blocked_by)、偏离同步、per-Agent 私有、跨智能体协作通过消息 / 回执对齐

斜杠命令补全(02-conversations/01-sending-messages.md

  • 命令类型表加 /plan
  • 新增「常用系统命令」表 + /plan 两种用法提示

英文版 i18n/en/ 完整镜像同步。


English Summary

Documentation refresh covering the Plan Mode + Task list capabilities shipped in v10.0.x, in both Chinese (default) and English (i18n/en/).

  • Plan Confirmation: when the agent auto-plans, three ways to force Plan Mode (📋 toggle / Shift+Tab / /plan slash), the three approval options with auto-exit behaviour, and the standard plan-file sections (Context / Steps / Critical Files / Artifacts / Verification / Risks & Rollback) saved under <workdir>/plans/.
  • Execution Monitoring: new "Task List" section describing live status updates, dependencies, deviation tracking, per-agent privacy, and how multi-agent teams sync via messages/receipts.
  • Slash Commands: /plan added to the command table plus a tip box covering its two usage forms.

Test plan

  • pnpm build 通过(zh-Hans + en 双语;onBrokenLinks: 'throw' 守卫无失效内部链接)
  • PR 预览部署后人工 review 中文版渲染效果
  • PR 预览部署后人工 review 英文版渲染效果
  • 三个文档 admonition(:::tip / :::info / :::warning)渲染正常
  • 跨章节链接 ../04-delegation/02-plan-confirmation.md#asking-the-agent-to-always-plan-first 可点击跳转

补齐 v10.0.x 引入的 Plan 模式与 Task 清单的客户向说明(中英双语同步):

计划确认(04-delegation/02-plan-confirmation.md):
- 新增「智能体什么时候会主动制定计划」表,列出自动触发条件与不触发条件
- 新增「主动要求先做计划」一节,介绍三种显式开启入口:
  · 📋 toggle 按钮(含视觉提示)
  · Shift+Tab 快捷键
  · /plan 斜杠命令(两种用法)
- 新增「强制模式与自动判断的区别」对比表
- 新增「审批的三个选项」(批准 / 修改 / 拒绝,含自动退出说明)
- 新增「计划文件的位置」一节:每个智能体工作目录下的 plans/ 子文件夹
  + plan 文件标准章节(Context / Steps / Critical Files / Artifacts /
  Verification / Risks & Rollback)

执行监控(04-delegation/03-execution-monitoring.md):
- 步骤状态加 🔹 待办、🗑️ 已放弃
- 新增「任务清单」一大节,覆盖:清单样子、状态立即更新纪律、依赖关系、
  偏离同步、per-Agent 私有、跨智能体协作通过消息/回执对齐

斜杠命令(02-conversations/01-sending-messages.md):
- 命令类型表加 /plan
- 新增「常用系统命令」表 + /plan 两种用法 tip

英文 i18n 同步上述全部内容。docusaurus build(zh-Hans + en)通过,
无失效链接。
Copilot AI review requested due to automatic review settings May 17, 2026 09:59
@vercel
Copy link
Copy Markdown

vercel Bot commented May 17, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment May 17, 2026 10:33am

Request Review

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates bilingual user-guide documentation for Plan Mode, task lists, and /plan slash-command usage.

Changes:

  • Expands Plan Confirmation docs with auto-plan triggers, forced Plan Mode entry points, approval options, and plan-file locations.
  • Adds Task List guidance to Execution Monitoring docs.
  • Adds /plan to slash-command documentation in Chinese and English.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
docs/02-user-guide/04-delegation/02-plan-confirmation.md Chinese Plan Mode documentation expansion
docs/02-user-guide/04-delegation/03-execution-monitoring.md Chinese task-list execution monitoring expansion
docs/02-user-guide/02-conversations/01-sending-messages.md Chinese slash-command documentation update
i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/04-delegation/02-plan-confirmation.md English Plan Mode documentation mirror
i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/04-delegation/03-execution-monitoring.md English task-list execution monitoring mirror
i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/01-sending-messages.md English slash-command documentation update
Comments suppressed due to low confidence (1)

docs/02-user-guide/04-delegation/03-execution-monitoring.md:96

  • The Chinese page now renders this section title twice in a row. This duplicate heading creates a redundant anchor/TOC entry and should be removed so the section only appears once.
## 固化步骤与灵活步骤

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/02-user-guide/04-delegation/03-execution-monitoring.md
Comment thread docs/02-user-guide/04-delegation/02-plan-confirmation.md Outdated
- 状态表加回 ⏳ 等待中 / Waiting 行:例图 / SVG 仍展示该状态,新增"待办 🔹"
  表达的是任务清单层面的待办,与运行管线"等待中 ⏳"是不同概念,两者并存
- 移除中文 execution-monitoring 重复的二级标题「## 固化步骤与灵活步骤」
- 修正中文 plan-confirmation "预期被动到" → "预期会动到" 错别字
@yi-ge yi-ge merged commit 78851bf into main May 17, 2026
3 checks passed
@yi-ge yi-ge deleted the docs/plan-tasks-feature branch May 17, 2026 10:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants