docs(ai-coach): v3 技术方案同步最近两次代码提交(卡片修改 schema 5、Planning Authority) - #553
Merged
Xu-create-ops merged 2 commits intoSep 18, 2026
Merged
Conversation
…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>
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>
Owner
Author
|
已按这个改:版本只记代码里的最新值,不再逐次记录。
提交 |
Xu-create-ops
approved these changes
Sep 18, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
只改
docs/ai-action-coach-technical-design-v3.md,+228 / -20。范围只限ai-coach-v3-pro上最近两次代码提交,文档其他部分没有重新核对。没有跑构建、测试或模型评估。写法沿用 1.1.1 / 1.1.2:加一个带日期的进展小节,再在受影响的章节原位注明现状,不删历史记录。
64faf4fbAI 修改卡片(之前文档里没有)ChangedFields的清空规则、current_card/item_N临时引用键、ProposalSetMutationHandler原子校验和全部原因码、歧义转一个澄清问题、Post-Policy 决策、确认文案由服务端生成、客户端draftDirty互斥。proposalSetMutation、update_proposal_set、proposal_update、ProposalUpdateResponse。AskGentleQuestion/AskClarifyingQuestion/UpdateProposalSet,移除SupersedeProposalSet)。38e8b80eReconstructing Session State(1.1.2 已写行为,这里只补命名和版本)PlanningReadinessCalculator/PlanningDecision→PlanningAuthorityCalculator/PlanningAuthority,在 2 节、7.2、12 节、14 节注明对应关系。17.2、17.3 是历史记录和 Clarify 设计,保留旧名没动。RequireProposalWhenPlanningReady、AllowExplicitContinuousExploration,MaxConsecutiveQuestionTurns改名,降级目标统一为ContinueListening,新增PlanningQuestionNotAuthorized。AllowedActions检查,只保留start_now单任务限制。需要 @Xu-create-ops 确认的一点
1.1.2 写的 Companion 版本是 rules v4 / policy v3 / planning v4 / support v3 / prompts v5,但
38e8b80e里AiCoachModeDefinition.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