Skip to content

docs: 说明文件化 Plan 协作流程 - #33

Merged
yi-ge merged 5 commits into
mainfrom
docs/file-backed-plan-protocol
Jul 28, 2026
Merged

docs: 说明文件化 Plan 协作流程#33
yi-ge merged 5 commits into
mainfrom
docs/file-backed-plan-protocol

Conversation

@yi-ge

@yi-ge yi-ge commented Jul 23, 2026

Copy link
Copy Markdown
Member

摘要

本 PR 同步中英文用户文档,说明 Plan 是工作目录中可审阅、可修订、可版本化的文件,而不是需要进入/退出的模式或整份方案审批流程;同时说明团队目录的真实激活、可见标识、成员继承和高可靠 team_only 模式。

具体变更

  • 重写计划协作章节,说明 .desirecore/plans//PLAN.md、revisions、自然语言修订和安全边界。
  • 明确“认可 Plan”不等于执行授权;发送、发布、删除等动作仍在实际发生前走审批 / Human Gate。
  • 修正委派模型、教学六原语与执行监控中的旧语义:没有统一“批准计划”状态;用户可说“先只写计划”;Task 只在责任、阻塞、跨 Agent 协作或持续进度确有需要时创建,不机械复制每个 Plan 步骤。
  • 说明普通聊天点击团队目录会为当前具体 conversation 激活 teamId,并在输入框胶囊与右上角资源入口显示团队标识。
  • 说明每个会话的团队选择彼此隔离。
  • 说明团队创建自动建立共享目录绑定,组长、初始成员、后续成员和新主管动态继承,非成员不可见;绑定失败则创建失败。
  • 说明“仅使用团队工作目录”:团队目录成为唯一项目工作目录和 Plan 根,成员/全局目录不进入 related_workdirs,但原设置不会被删除。
  • 中文原文与英文 i18n 镜像同步更新。

验证

  • npm run build 通过;Docusaurus zh-Hans 与 en 均成功生成。
  • git diff --check 通过。
  • 旧的 blanket plan approval / every Plan step becomes Task 表述已全仓检索清理。
  • 当前 head:9cfd3b4c94a3cb62631835ee451cd681d720ab6b。

English summary

  • Reframes Plan as a versioned, user-editable workspace artifact rather than a mode or blanket approval state.
  • Separates natural plan review from action-level permissions and removes the rule that every Plan step becomes a Task.
  • Documents visible, conversation-scoped team activation and dynamic membership inheritance.
  • Documents the non-destructive team-only workspace option in both Chinese and English.

@vercel

vercel Bot commented Jul 23, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jul 28, 2026 12:53pm

Request Review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 55738127e7

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread docs/02-user-guide/04-delegation/02-plan-confirmation.md
Comment thread docs/02-user-guide/04-delegation/02-plan-confirmation.md

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1140a2a40f

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9cfd3b4c94

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread docs/04-concepts/02-delegation-model.md Outdated
- Add team-only directory exception to EN plan-confirmation.md (P2 #3)
- Align clarification and Plan ordering in delegation-model.md (P2 #4)
- Both CN and EN versions updated
@yi-ge
yi-ge merged commit 5f6371e into main Jul 28, 2026
3 checks passed
@yi-ge
yi-ge deleted the docs/file-backed-plan-protocol branch July 28, 2026 14:57
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.

1 participant