Skip to content

docs(ai-coach): v3 技术方案同步最近两次代码提交(卡片修改 schema 5、Planning Authority) - #553

Merged
Xu-create-ops merged 2 commits into
ai-coach-v3-profrom
docs/ai-coach-v3-sync-card-editing
Sep 18, 2026
Merged

Xu-create-ops merged 2 commits into
ai-coach-v3-profrom
docs/ai-coach-v3-sync-card-editing

Conversation

@sol-wizard

Copy link
Copy Markdown
Owner

只改 docs/ai-action-coach-technical-design-v3.md,+228 / -20。范围只限 ai-coach-v3-pro 上最近两次代码提交,文档其他部分没有重新核对。没有跑构建、测试或模型评估。

写法沿用 1.1.1 / 1.1.2:加一个带日期的进展小节,再在受影响的章节原位注明现状,不删历史记录。

64faf4fb AI 修改卡片(之前文档里没有)

  • 新增 1.1.3 进展小节。
  • 新增 11.2 ProposalSetMutation Candidate:add / update / remove 三种操作、ChangedFields 的清空规则、current_card / item_N 临时引用键、ProposalSetMutationHandler 原子校验和全部原因码、歧义转一个澄清问题、Post-Policy 决策、确认文案由服务端生成、客户端 draftDirty 互斥。
  • 10 节:schema 4 → 5,proposalSetMutationupdate_proposal_setproposal_updateProposalUpdateResponse
  • 7.5 加三条转换(替换条目、删空即丢弃、卡片歧义提问不消耗规划澄清预算);8.2 更新有卡片时的包络(加 AskGentleQuestion / AskClarifyingQuestion / UpdateProposalSet,移除 SupersedeProposalSet)。
  • 13.5、13.8 矩阵:Execute 和 Companion 的「修改当前 Proposal」标为已实现,Clarify 标为未开放。
  • 14 节 Guard 顺序、15 节两条固定文案、23 节原因码 16–19、24.1 列出 11 项新测试和还没覆盖的分支。
  • 25 节第 4 项「是否开放模型修改卡片」标为已解决,留下三个后续问题。

38e8b80e Reconstructing Session State(1.1.2 已写行为,这里只补命名和版本)

  • PlanningReadinessCalculator / PlanningDecisionPlanningAuthorityCalculator / PlanningAuthority,在 2 节、7.2、12 节、14 节注明对应关系。17.2、17.3 是历史记录和 Clarify 设计,保留旧名没动。
  • 记录删除的 RequireProposalWhenPlanningReadyAllowExplicitContinuousExplorationMaxConsecutiveQuestionTurns 改名,降级目标统一为 ContinueListening,新增 PlanningQuestionNotAuthorized
  • 18 节注明 Confirm Handler 不再做通用的 AllowedActions 检查,只保留 start_now 单任务限制。

需要 @Xu-create-ops 确认的一点

1.1.2 写的 Companion 版本是 rules v4 / policy v3 / planning v4 / support v3 / prompts v5,但 38e8b80eAiCoachModeDefinition.cs 是 rules v7 / policy v7 / planning v7 / support v5 / prompts v7。我没有改 1.1.2 的原文,只在 1.1.3 里标了「待确认」。以哪个为准你定,我再改。

对评测 PR #546 的影响(不在本 PR 内)

E7 的期望要改成 UpdateProposalSet;依赖 Evidence 来源校验的断言(A2b / A3b / E1 / E6)和 C8 的触发条件要跟着改;引用 PlanningReadiness / PlanningDecision / AllowedPlanningAction 的评测代码需要换成 PlanningAuthority。等澄清模式推上来后一起 rebase。

🤖 Generated with Claude Code

…lanning Authority

Syncs docs/ai-action-coach-technical-design-v3.md with the last two code
commits on ai-coach-v3-pro only; nothing else in the doc is re-audited.

64faf4f (AI-powered card editing), previously undocumented:
- new 1.1.3 progress note and new 11.2 ProposalSetMutation section
  (operations, ephemeral item_N keys, atomic handler, ambiguity ->
  one question, deterministic acknowledgement, client dirty-edit guard)
- contract schema 4 -> 5, update_proposal_set / proposal_update
- 7.5 transitions, 8.2 pending-card envelope, 13.5 / 13.8 matrix rows,
  guard order, fallback copy, reason codes 17-19, test map and gaps
- section 25 item 4 marked resolved

38e8b80 (Reconstructing Session State), on top of 1.1.2:
- PlanningReadiness/PlanningDecision -> PlanningAuthority mapping, noted
  in current-behaviour sections; 17.2 / 17.3 history keeps the old names
- removed policy flags, unified ContinueListening downgrade,
  PlanningQuestionNotAuthorized, Confirm handler / DraftNotFound changes
- flags for confirmation: 1.1.2 lists Companion rules v4 / policy v3 /
  planning v4 / support v3 / prompts v5, code at 38e8b80 has
  v7 / v7 / v7 / v5 / v7

Docs only. No build, tests or model evaluation were run.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@Xu-create-ops

Copy link
Copy Markdown
Collaborator

以代码为准,不需要记录版本,以最后一个版本为准即可。

Per review on #553: the code is the source of truth and version history
does not need to be recorded.

- 1.1.2: replace the stale per-commit version list with a pointer to the
  current values
- 1.1.3: one line with the latest versions from AiCoachModeDefinition.cs
  (Execution rules v8 / policy v6 / planning v3 / prompts v11; Companion
  rules v8 / policy v8 / planning v7 / support v5 / prompts v8; schema 5)
- 1.1.3: drop the per-commit Companion versions and the pending
  confirmation note

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@sol-wizard

Copy link
Copy Markdown
Owner Author

已按这个改:版本只记代码里的最新值,不再逐次记录。

  • 1.1.2 那行旧版本号换成「以代码为准,当前值见 1.1.3」
  • 1.1.3 只留一行最新版本:Execution rules v8 / policy v6 / planning v3 / prompts v11;Companion rules v8 / policy v8 / planning v7 / support v5 / prompts v8;schema 5
  • 删掉了按提交分列的 Companion 版本和「待确认」

提交 1cd52b46,可以再看一下。

@Xu-create-ops
Xu-create-ops merged commit 9993be6 into ai-coach-v3-pro Sep 18, 2026
1 check failed
@Xu-create-ops
Xu-create-ops deleted the docs/ai-coach-v3-sync-card-editing branch September 18, 2026 13:43
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