Update product docs

[github-actions]

Synchronizes long-term product docs from merged implementation pull requests.

Latest decision:

• source PR: fix: validate product report spec links #249
• docs update: required
• reason: PR fix: validate product report spec links #249 改变了 product change report 的长期来源引用契约和状态校验行为：spec 引用必须使用从 docs/updates/ 出发的仓库相对 Markdown 链接，并且错误 spec source reference 会被拒绝。现有产品文档只记录了 commit ID 和 related issue URL 校验，未覆盖该已合并行为。
• source URL: fix: validate product report spec links #249

Affected docs:

• docs/product/raw/product-change-reports.md

Source context:

• PR fix: validate product report spec links #249
• Issue product report 中 spec 链接地址不对 #239
• specs/issue-239/product.md

Patch summary:
更新 docs/product/raw/product-change-reports.md 的来源引用和校验行为章节，补充 spec source reference 的合法链接格式、非法目标类型和状态校验拒绝规则。

Processed decisions in this PR:

• Omitted 90 older processed decisions to keep the PR body within GitHub limits.

• PR feat(product): add product wiki query agent #204: feat(product): add product wiki query agent

  • docs update: required
  • reason: PR feat(product): add product wiki query agent #204 新增用于 Product LLM Wiki 查询的 GitHub Copilot custom agent，并让安装脚本向目标仓库交付 .github/agents/。这是长期产品入口和安装同步范围的变化，现有产品文档尚未完整覆盖。
  • url: feat(product): add product wiki query agent #204
  • affected docs:
  • docs/product/raw/agent-directory-layout.md
  • docs/product/raw/project-installer.md
  • docs/product/raw/product-wiki-query-agent.md
  • change summary:
    记录 .github/agents/ 是随模板交付的 GitHub Copilot custom agent 目录，补充 Product Wiki Query agent 的查询与回答边界，并把安装同步范围更新为包含 .github/agents/。

• PR Add product change report for 2026-05-29 #208: Add product change report for 2026-05-29

  • docs update: not-needed
  • reason: PR Add product change report for 2026-05-29 #208 只新增 2026-05-29 的产品变更报告并更新 docs/updates ledger，属于时间序列更新产物。它没有改变长期产品概念、工作流、权限、生命周期、配置语义或公开契约，因此不需要修改 docs/product/。
  • url: Add product change report for 2026-05-29 #208
  • affected docs:
  • none
  • change summary:
    无需产品文档补丁；按 not-needed 决策不修改 docs/product/。

• PR Compile product wiki #209: Compile product wiki

  • docs update: not-needed
  • reason: PR Compile product wiki #209 只更新了 docs/product/wiki/ 下的 Product LLM Wiki 编译产物，没有修改产品行为、workflow 契约或权威 raw source。现有 docs/product/raw/product-wiki-compile-workflow.md 已说明 wiki 是从 docs/product/raw/ 生成的查询层，raw 文档仍是产品事实的权威来源。
  • url: Compile product wiki #209
  • affected docs:
  • none
  • change summary:
    无需修改长期产品文档；本次只写入 docs sync 决策结果。

• PR Add product change report for 2026-05-31 #212: Add product change report for 2026-05-31

  • docs update: not-needed
  • reason: PR Add product change report for 2026-05-31 #212 only adds a time-series product change report and its updates ledger under docs/updates/. It does not introduce or change long-term product behavior, workflows, API contracts, configuration semantics, or authoritative product documentation.
  • url: Add product change report for 2026-05-31 #212
  • affected docs:
  • none
  • change summary:
    No product docs patch is needed because this update belongs only to the time-series product change report artifacts.

• PR Compile product wiki #213: Compile product wiki

  • docs update: not-needed
  • reason: PR Compile product wiki #213 仅重新编译 docs/product/raw/ 到 docs/product/wiki/，变更范围是派生 wiki 页面和编译日志。现有产品文档已声明 docs/product/raw/ 是权威来源，且本次没有 raw 文档、spec、产品代码或 workflow 行为变更。
  • url: Compile product wiki #213
  • affected docs:
  • none
  • change summary:
    无需产品文档补丁；不修改 docs/product/。

• PR fix: 跳过 product docs sync 中缺失的 issue 引用 #215: fix: 跳过 product docs sync 中缺失的 issue 引用

  • docs update: required
  • reason: PR fix: 跳过 product docs sync 中缺失的 issue 引用 #215 改变了 Product Docs Sync 的长期 workflow 行为：单个 linked issue 读取失败时不再中断上下文准备，而是跳过该 issue 并继续处理 merged PR。现有产品文档只描述了 issue 引用进入上下文和 specs 读取流程，未覆盖缺失或不可读取 issue 的过滤规则。
  • url: fix: 跳过 product docs sync 中缺失的 issue 引用 #215
  • affected docs:
  • docs/product/raw/product-docs-sync-workflow.md
  • change summary:
    更新 Product Docs Sync workflow 权威文档，说明 unreadable linked issue 会被跳过，linked_issues 和相关 specs 只包含成功读取的 issue，且该情况不会让可处理的 merged PR 变为 should_run=false。

• PR fix: append product docs sync PR comments #217: fix: append product docs sync PR comments

  • docs update: required
  • reason: PR fix: append product docs sync PR comments #217 changed the long-term Product Docs Sync workflow behavior: every create or update of the docs sync PR now appends a per-run PR comment with the current decision details. Existing product docs described the fixed-branch PR body and ledger behavior but did not cover the new conversation comment record.
  • url: fix: append product docs sync PR comments #217
  • affected docs:
  • docs/product/raw/product-docs-sync-workflow.md
  • change summary:
    Updated the Product Docs Sync workflow raw product doc to describe appended per-run PR comments on the docs sync PR, including fields, uncertain confirmation visibility, and the rule that old bot comments are not edited.

• PR Compile product wiki #222: Compile product wiki

  • docs update: not-needed
  • reason: PR Compile product wiki #222 only compiled the generated docs/product/wiki knowledge layer from existing docs/product/raw sources. It did not introduce new product behavior, and the authoritative raw product docs already include the relevant source documents.
  • url: Compile product wiki #222
  • affected docs:
  • none
  • change summary:
    No docs/product changes are needed.

• PR Compile product wiki #226: Compile product wiki

  • docs update: not-needed
  • reason: PR Compile product wiki #226 只是将现有 docs/product/raw/ 内容重新编译为 docs/product/wiki/ 知识层，没有引入新的权威产品行为、workflow、配置语义或公开契约。变更属于派生 wiki 内容同步，长期产品事实仍已由现有 raw 文档覆盖。
  • url: Compile product wiki #226
  • affected docs:
  • none
  • change summary:
    无需修改 docs/product/；本次只记录 not-needed 决策。

• PR fix(review): suppress repeated bot review comments #227: fix(review): suppress repeated bot review comments

  • docs update: required
  • reason: PR fix(review): suppress repeated bot review comments #227 changes long-term AI PR Review behavior by adding prior review discussion snapshots and duplicate suppression for resolved, maintainer-dismissed, and still-unresolved bot inline comments. Existing product docs covered review workflow behavior but did not document this discussion context or its instruction-safety boundary.
  • url: fix(review): suppress repeated bot review comments #227
  • affected docs:
  • docs/product/raw/pr-review-verdict.md
  • change summary:
    Updated docs/product/raw/pr-review-verdict.md to document review_discussion_context.json generation, duplicate-suppression rules, maintainer dismissal handling, unresolved-thread handling, and REVIEW_BOT_LOGIN source attribution.

• PR 修复 review dismiss 误判和换行输出 #228: 修复 review dismiss 误判和换行输出

  • docs update: required
  • reason: PR 修复 review dismiss 误判和换行输出 #228 改变了 AI PR Review 的长期用户可见行为：维护者 dismissal 识别不再把否定或疑问语境中的 intentional 裸词当作已 dismiss，并且发布 review 前会把 fenced code block 外的字面量 \n 规范化为真实换行。现有产品文档只概括了 dismissed/resolved 去重和 review 输出契约，未覆盖这些精确语义。
  • url: 修复 review dismiss 误判和换行输出 #228
  • affected docs:
  • docs/product/raw/pr-review-verdict.md
  • change summary:
    更新 docs/product/raw/pr-review-verdict.md，补充 maintainer dismissal 的肯定语义要求、否定或疑问 intentional 回复的处理方式，以及 GitHub review 发布前对 markdown body/comment 中字面量 \n 的换行规范化规则。

• PR fix(review): 使用 GitHub PR diff 快照 #231: fix(review): 使用 GitHub PR diff 快照

  • docs update: required
  • reason: PR fix(review): 使用 GitHub PR diff 快照 #231 changed the authoritative PR diff snapshot behavior for GitHub-hosted review and /fix workflows from a local base/head git diff to the GitHub PR diff API with before-and-after SHA validation. This is long-term workflow and public failure-semantics knowledge that was not explicitly covered by the existing product docs.
  • url: fix(review): 使用 GitHub PR diff 快照 #231
  • affected docs:
  • docs/product/raw/pr-review-verdict.md
  • docs/product/raw/pr-comment-response-workflow.md
  • change summary:
    Document that GitHub workflow PR diff snapshots for AI PR Review and /fix now come from the GitHub PR diff API, and that the workflows fail if the PR head or base SHA changes while preparing the diff.

• PR Compile product wiki #234: Compile product wiki

  • docs update: not-needed
  • reason: PR Compile product wiki #234 only compiled existing authoritative docs/product/raw/ content into docs/product/wiki/. It did not change implementation behavior, specs, raw product docs, or any long-term product rule that is not already represented by the existing product documentation.
  • url: Compile product wiki #234
  • affected docs:
  • none
  • change summary:
    No product docs patch is needed because the merged PR updated only the generated wiki query layer from existing raw sources.

• PR Compile product wiki #238: Compile product wiki

  • docs update: not-needed
  • reason: PR Compile product wiki #238 only updates compiled Product LLM Wiki pages under docs/product/wiki/ from existing docs/product/raw/ sources. The authoritative long-term product facts are already covered by raw docs, so no additional product docs patch is warranted.
  • url: Compile product wiki #238
  • affected docs:
  • none
  • change summary:
    No docs/product changes needed; the merged PR is a compiled wiki refresh from existing authoritative raw product docs.

• PR Compile product wiki #242: Compile product wiki

  • docs update: not-needed
  • reason: PR Compile product wiki #242 仅编译并刷新 docs/product/wiki/ 查询层，变更文件全部位于 compiled wiki。它没有修改实现、spec 或 docs/product/raw/ 权威来源，也没有引入新的长期产品行为或规则。
  • url: Compile product wiki #242
  • affected docs:
  • none
  • change summary:
    无需文档补丁；现有 raw product docs 仍是权威来源，本次合并只是基于这些来源更新派生 wiki。

• PR refactor(workflows): extract shared script helpers #245: refactor(workflows): extract shared script helpers

  • docs update: not-needed
  • reason: PR refactor(workflows): extract shared script helpers #245 is a workflow script refactor that extracts shared helper modules and moves existing context, GitHub API, ledger, metadata, and artifact I/O logic behind reusable Python helpers. The merged diff does not introduce a new product workflow, lifecycle, permission model, configuration contract, or user-visible behavior that is not already covered by the existing product docs sync workflow documentation.
  • url: refactor(workflows): extract shared script helpers #245
  • affected docs:
  • none
  • change summary:
    No product docs patch is needed because the change is internal workflow script structure and regression coverage only.

• PR refactor(review): extract shared review contracts #246: refactor(review): extract shared review contracts

  • docs update: required
  • reason: PR refactor(review): extract shared review contracts #246 changed long-term AI PR Review behavior by introducing a shared review contract and moving local review snapshots/output to system temporary-directory paths. Existing authoritative raw product docs still described repo-root local snapshots and did not document .agents/contracts/ as a shared workflow/skill contract area.
  • url: refactor(review): extract shared review contracts #246
  • affected docs:
  • docs/product/raw/agent-directory-layout.md
  • docs/product/raw/pr-review-verdict.md
  • change summary:
    Updated authoritative raw product docs to describe .agents/contracts/, shared review contract/schema ownership, core review entrypoints with repo companion guidance, and temporary-directory local review snapshot/output paths.

• PR Compile product wiki #248: Compile product wiki

  • docs update: not-needed
  • reason: PR Compile product wiki #248 only updated the generated Product LLM Wiki compile log under docs/product/wiki/log.md. It did not change authoritative raw product knowledge, specs, workflows, permissions, lifecycle rules, APIs, configuration semantics, or user-visible product behavior.
  • url: Compile product wiki #248
  • affected docs:
  • none
  • change summary:
    No product docs patch is needed; the change is a generated wiki compile log entry and belongs outside authoritative long-term product docs.

• PR refactor(workflows): move handoff files to temp dir #247: refactor(workflows): move handoff files to temp dir

  • docs update: not-needed
  • reason: PR refactor(workflows): move handoff files to temp dir #247 改变了 spec、implementation 和 PR comment response workflow 的 handoff 路径与提交排除契约，但该 PR 已同步更新对应的长期产品文档。现有 docs/product/raw/implementation-workflow.md、docs/product/raw/pr-comment-response-workflow.md 和 docs/product/raw/spec-workflow.md 已覆盖合并后的 .codex-runtime/handoff 行为、metadata 边界和 spec handoff 限制。
  • url: refactor(workflows): move handoff files to temp dir #247
  • affected docs:
  • none
  • change summary:
    无需补丁；合并 PR 已包含并落地所需的 docs/product/raw 更新。

• PR fix: validate product report spec links #249: fix: validate product report spec links

  • docs update: required
  • reason: PR fix: validate product report spec links #249 改变了 product change report 的长期来源引用契约和状态校验行为：spec 引用必须使用从 docs/updates/ 出发的仓库相对 Markdown 链接，并且错误 spec source reference 会被拒绝。现有产品文档只记录了 commit ID 和 related issue URL 校验，未覆盖该已合并行为。
  • url: fix: validate product report spec links #249
  • affected docs:
  • docs/product/raw/product-change-reports.md
  • change summary:
    更新 docs/product/raw/product-change-reports.md 的来源引用和校验行为章节，补充 spec source reference 的合法链接格式、非法目标类型和状态校验拒绝规则。

This PR may accumulate multiple product docs sync decisions until it is reviewed and merged.

[github-actions]

Product Docs Sync processed a source PR.

• source PR: fix: validate product report spec links #249
• docs update: required
• reason: PR fix: validate product report spec links #249 改变了 product change report 的长期来源引用契约和状态校验行为：spec 引用必须使用从 docs/updates/ 出发的仓库相对 Markdown 链接，并且错误 spec source reference 会被拒绝。现有产品文档只记录了 commit ID 和 related issue URL 校验，未覆盖该已合并行为。
• source URL: fix: validate product report spec links #249

Affected docs:

• docs/product/raw/product-change-reports.md

Patch summary:
更新 docs/product/raw/product-change-reports.md 的来源引用和校验行为章节，补充 spec source reference 的合法链接格式、非法目标类型和状态校验拒绝规则。