fix: 修复 Issue 评论中的本地路径和误识别链接

[CodeCasterX]

问题摘要 / Issue Summary

修复 Issue 评论中的本地路径和误识别链接

版本信息 / Version Information

N/A

运行环境 / Runtime Environment

N/A

发生了什么？/ What happened?

修复同步到 GitHub Issue 的任务文件和生命周期产物中的错误超链接。同步范围内的本地产物路径不再生成可点击的相对链接，而以反引号代码文本表示；同步过程继续原样发布本地 Markdown，保证本地与远端内容一致。同时处理类似 @2x 被 GitHub 误识别为用户链接的文本，并为同步内容增加必要的链接约束或校验，避免本地 workspace 路径、临时任务文件及易失效链接进入 Issue 评论。

期望的行为 / Expected Behavior

N/A

重现步骤 / Steps to Reproduce

N/A

相关日志 / Relevant Logs

N/A

额外信息 / Additional Context

N/A

任务输入

来源

• 用户当次请求：直接创建任务跟踪 Issue 评论链接问题。
• 用户前序确认：本地与远端需要遵循完全一致的规则。
• 用户当次确认：需要避免自动链接的文本使用反引号代码格式框起。
• 前序链接审计及代码核对结果。

已确认事实与证据

• 已核实：生命周期核心会在本地 task.md 中生成形如 [需求分析报告（Round 1）](analysis.md) 的相对链接。
• 已核实：Issue 评论渲染会将 task.md 和产物正文原样嵌入评论，因此本地相对路径在 Issue 上会被解析为错误地址。
• 已核实：基础 task.md 模板本身没有产物链接；链接由任务生命周期推进时追加，产物报告中也可能存在手写相对链接。
• 已核实：GitHub 会把正文中的 @用户名 自动渲染为用户主页链接；例如“清晰度 @2x”被误识别成用户 2x。
• 前序审计确认普通格式的 Issue、PR 和 commit 链接整体正常，主要问题集中在本地或相对产物路径。

约束

• 本地 Markdown 与远端 Issue 评论的业务正文必须保持一致，不能依赖同步阶段改写链接。
• 只治理会同步到 Issue 的任务及产物 Markdown，不应删除 README 等正式项目文档中原本有效的相对链接。
• 修改应覆盖自动生成链接和产物内容中的同类路径，避免修复后再次产生。

已确认决策

• 用户已确认：同步范围内的本地产物文件引用改为反引号代码文本，而不是可点击链接。
• 用户已确认：类似 @2x 的非用户提及使用反引号代码格式，避免 GitHub 自动生成用户链接。
• 用户已确认：本地生成内容与远端发布内容使用同一套表示规则。

候选与否决方案

• 已否决：在 Issue 同步阶段把本地链接转换成另一种远端格式；这会破坏本地与远端一致性。
• Agent 建议候选：在同步前增加针对 workspace 路径、相对产物链接和意外 @mention 的校验，具体覆盖范围留待需求分析。
• Agent 建议候选：确需长期可点击的仓库文件链接时使用固定 commit permalink；是否允许及适用范围留待需求分析。

验收标准

• 生成任务生命周期产物引用后，本地 task.md 使用类似 需求分析报告（Round 1）： 加代码格式文件名的非链接表示；同步到 Issue 后正文表示一致且文件名不可点击。
• 同步范围内的产物报告引用本地 workspace 文件时，不产生指向 Issue 相对地址、/workspace/、/Users/ 或临时任务分支文件的错误链接。
• 正文中的非用户语义 @2x 使用代码格式后，GitHub 不再将其渲染为用户主页链接。
• 项目正式文档中原本有效的相对链接，以及已确认有效的 Issue、PR、commit 和外部链接不受影响。
• 相关结构性测试和项目测试通过，并能阻止同类同步内容回归。

未决事项

• 历史 Issue 评论中已经发布的错误链接是否需要批量回填修复，范围尚未由用户确认。
• 真实但已失效的用户提及（账号改名、删除或不可访问）是否纳入本任务处理，尚未由用户确认。

[CodeCasterX]

任务文件

codex · TASK-20260826-184851

元数据 (frontmatter)

---
id: TASK-20260826-184851
type: bugfix
branch: agent-infra-bugfix-issue-comment-local-links
delivery_remote: origin
delivery_base_ref: main
workflow: bug-fix
status: active
created_at: 2026-08-26 18:48:51+08:00
updated_at: 2026-09-01 20:45:15+08:00
agent_infra_version: v0.9.11
priority: High
effort: Medium
start_date: 2026-09-01
target_date:
current_step: code-review
assigned_to: codex
pr_status: pending
task_create_key_digest: f6dc9c259fc52836aa514360c60ab86bce067e5099493c69557ba3c8bff6544f
task_create_candidate_digest: 5d802d28aa55c38c2984d9b8645ba2a27da5bda75fb1456d51644c03828d5528
issue_number: 941
checkpoint_commit: 81ff057030c7c32c72f88a866d6c797d91f082cd
---

任务：修复 Issue 评论中的本地路径和误识别链接

描述

修复同步到 GitHub Issue 的任务文件和生命周期产物中的错误超链接。同步范围内的本地产物路径不再生成可点击的相对链接，而以反引号代码文本表示；同步过程继续原样发布本地 Markdown，保证本地与远端内容一致。同时处理类似 @2x 被 GitHub 误识别为用户链接的文本，并为同步内容增加必要的链接约束或校验，避免本地 workspace 路径、临时任务文件及易失效链接进入 Issue 评论。

任务输入

来源

• 用户当次请求：直接创建任务跟踪 Issue 评论链接问题。
• 用户前序确认：本地与远端需要遵循完全一致的规则。
• 用户当次确认：需要避免自动链接的文本使用反引号代码格式框起。
• 前序链接审计及代码核对结果。

已确认事实与证据

• 已核实：生命周期核心会在本地 task.md 中生成形如“需求分析报告（Round 1）：analysis.md”的代码文本。
• 已核实：Issue 评论渲染会将 task.md 和产物正文原样嵌入评论，因此本地相对路径在 Issue 上会被解析为错误地址。
• 已核实：基础 task.md 模板本身没有产物链接；链接由任务生命周期推进时追加，产物报告中也可能存在手写相对链接。
• 已核实：GitHub 会把正文中的 @用户名 自动渲染为用户主页链接；例如“清晰度 @2x”可避免被误识别成用户 2x。
• 前序审计确认普通格式的 Issue、PR 和 commit 链接整体正常，主要问题集中在本地或相对产物路径。

约束

• 本地 Markdown 与远端 Issue 评论的业务正文必须保持一致，不能依赖同步阶段改写链接。
• 只治理会同步到 Issue 的任务及产物 Markdown，不应删除 README 等正式项目文档中原本有效的相对链接。
• 修改应覆盖自动生成链接和产物内容中的同类路径，避免修复后再次产生。

已确认决策

• 用户已确认：同步范围内的本地产物文件引用改为反引号代码文本，而不是可点击链接。
• 用户已确认：类似 @2x 的非用户提及使用反引号代码格式，避免 GitHub 自动生成用户链接。
• 用户已确认：本地生成内容与远端发布内容使用同一套表示规则。

候选与否决方案

• 已否决：在 Issue 同步阶段把本地链接转换成另一种远端格式；这会破坏本地与远端一致性。
• Agent 建议候选：在同步前增加针对 workspace 路径、相对产物链接和意外 @mention 的校验，具体覆盖范围留待需求分析。
• Agent 建议候选：确需长期可点击的仓库文件链接时使用固定 commit permalink；是否允许及适用范围留待需求分析。

验收标准

• 生成任务生命周期产物引用后，本地 task.md 使用类似 需求分析报告（Round 1）： 加代码格式文件名的非链接表示；同步到 Issue 后正文表示一致且文件名不可点击。
• 同步范围内的产物报告引用本地 workspace 文件时，不产生指向 Issue 相对地址、/workspace/、/Users/ 或临时任务分支文件的错误链接。
• 正文中的非用户语义 @2x 使用代码格式后，GitHub 不再将其渲染为用户主页链接。
• 项目正式文档中原本有效的相对链接，以及已确认有效的 Issue、PR、commit 和外部链接不受影响。
• 相关结构性测试和项目测试通过，并能阻止同类同步内容回归。

未决事项

• 历史 Issue 评论中已经发布的错误链接是否需要批量回填修复，范围尚未由用户确认。
• 真实但已失效的用户提及（账号改名、删除或不可访问）是否纳入本任务处理，尚未由用户确认。

Brainstorming

• status: done
• question_count: 0
• pending_question:
• answered:

上下文

• 关联 Issue：N/A
• 关联 PR：N/A
• 分支：agent-infra-bugfix-issue-comment-local-links

需求

分析

需求分析报告（Round 1）：analysis.md

受影响的文件

• path/to/file1 - 变更描述
• path/to/file2 - 变更描述

需求分析报告（Round 2）：analysis-r2.md

设计

技术方案（Round 1）：plan.md

技术方案（Round 2）：plan-r2.md

技术方案（Round 3）：plan-r3.md

实现备注

实现报告（Round 1）：code.md

实现报告（Round 2）：code-r2.md

实现报告（Round 3）：code-r3.md

实现报告（Round 4）：code-r4.md

审查反馈

需求分析审查（Round 1）：review-analysis.md

需求分析审查（Round 2）：review-analysis-r2.md

技术方案审查（Round 1）：review-plan.md

技术方案审查（Round 2）：review-plan-r2.md

技术方案审查（Round 3）：review-plan-r3.md

技术方案审查（Round 4）：review-plan-r4.md

代码审查（Round 1）：review-code.md

代码审查（Round 2）：review-code-r2.md

代码审查（Round 3）：review-code-r3.md

代码审查（Round 4）

审查分歧账本

id	stage	round	severity	status	evidence
HD-1	analysis	-	decision	human-decided	task.md#HDR-1
HD-2	analysis	-	decision	human-decided	task.md#HDR-2
PL-1	plan	2	major	confirmed	review-plan-r3.md#PL-1-response
PL-2	plan	2	major	confirmed	review-plan-r3.md#PL-2-response
PL-3	plan	4	major	confirmed	review-plan-r4.md#PL-3-response
CD-1	code	2	major	closed	review-code-r2.md#CD-1-response
CD-2	code	2	major	closed	review-code-r2.md#CD-2-response
CD-3	code	2	major	closed	review-code-r2.md#CD-3-response
CD-4	code	3	major	human-decided	task.md#HDR-3
CD-5	code	3	major	closed	review-code-r3.md#CD-5-response
CD-6	code	4	major	open	review-code-r4.md#controlled-generation-raw-at

人工裁决

HDR-3

• 原账本 ID：CD-4
• 裁决时间：2026-09-01 19:41:16+08:00
• 裁决结果：选择简化方案 C：自动生成的同步内容默认不生成裸 @，仅在邮箱、真实用户 mention、发布日志固定格式等明确必要场景保留；手写或外部内容不自动改写、不额外校验，按原文同步，不因 @ 内容阻塞；不增加 @ 相关上下文解析规则。需要实现：调整受控生成内容的输出规则，保留必要场景，并取消普通 HTML tag 的额外确认解析边界。理由：当前问题源于无语义 @ 被平台误解析，生成端约束足以覆盖我们可控制的内容，方案更简单且不改变手写或外部正文。

HDR-2

• 原账本 ID：HD-2
• 裁决时间：2026-09-01 11:03:21+08:00
• 裁决结果：选择方案 A：正常生成和同步流程不查询 GitHub，只对明确的非用户语义 token（如 @2x）使用代码格式，并保留账号形态但意图不明的提及。若未来需要账号状态判断，另设独立的只读审计/诊断动作，仅报告结果，不改写内容，也不阻塞正常同步。理由：账号是否存在不能证明作者是否有意提及，且查询会引入网络、权限和限流依赖。

HDR-1

• 原账本 ID：HD-1
• 裁决时间：2026-09-01 09:18:59+08:00
• 裁决结果：选择方案 A：仅修复未来生成/同步的内容，不批量回填历史 Issue 评论。理由：当前任务只明确未来规则，未提供可安全批量回填所需的 Issue 范围、必要性、期限和退出条件。

实现输入

id	ledger_id	decision_evidence	stage	needs_implementation	decided_at	status	consumed_by
II-1	CD-4	task.md#HDR-3	code	true	2026-09-01 19:41:16+08:00	pending

工作流告警

id	time	step	severity	code	status	target	message	action	resolved_at	resolution
WW-1	2026-08-26 18:49:06+08:00	create-task	ACTION_REQUIRED	ISSUE_CREATE_FAILED	resolved	issue	NETWORK_RETRY_EXHAUSTED: gh: API rate limit exceeded for 94.177.131.184. (But here's the good news: Authenticated requests get a higher rate limit. Check out the documentation for more details.) (HTTP 403) (retry exhausted)	Fix platform authentication or connectivity, then retry Issue creation for this task.	2026-09-01 11:35:12+08:00	Issue #941 was created and bound successfully; task and lifecycle artifact comments were backfilled.
WW-2	2026-09-01 15:08:12+08:00	code-task	ACTION_REQUIRED	COMMENT_SYNC_FAILED	resolved	task	COMMENT_PAYLOAD_INVALID: 明确的非用户 token 必须使用行内代码格式 at line 45, column 47: @2x	修复本地 task 内容后重跑 code-task	2026-09-01 15:09:39+08:00	已修复当前 task.md 的 token 和 artifact 表示，并成功重试 task 评论同步

活动日志

• 2026-08-26 18:48:51+08:00 — Create Task [started] by codex — started
• 2026-08-26 18:48:51+08:00 — Create Task by codex — Task created from structured candidate
• 2026-09-01 00:03:08+08:00 — Analyze Task (Round 1) [started] by codex — started
• 2026-09-01 00:08:31+08:00 — Analyze Task (Round 1) by codex — Analysis completed → analysis.md
• 2026-09-01 00:12:35+08:00 — Review Analysis (Round 1) [started] by codex — started
• 2026-09-01 00:19:49+08:00 — Review Analysis (Round 1) by codex — Verdict: Changes Requested, blockers: 0, major: 0, minor: 0, Manual-validation: 0 → review-analysis.md
• 2026-09-01 09:18:59+08:00 — Human Decision by human — HD-1 decided → HDR-1
• 2026-09-01 11:03:21+08:00 — Human Decision by human — HD-2 decided → HDR-2
• 2026-09-01 11:09:35+08:00 — Analyze Task (Round 2) [started] by codex — started
• 2026-09-01 11:11:00+08:00 — Analyze Task (Round 2) by codex — Analysis completed → analysis-r2.md
• 2026-09-01 11:17:02+08:00 — Review Analysis (Round 2) [started] by codex — started
• 2026-09-01 11:22:36+08:00 — Review Analysis (Round 2) by codex — Verdict: Approved, blockers: 0, major: 0, minor: 0, Manual-validation: 0 → review-analysis-r2.md
• 2026-09-01 11:53:53+08:00 — Plan Task (Round 1) [started] by codex — started
• 2026-09-01 12:01:35+08:00 — Plan Task (Round 1) by codex — Plan completed, awaiting human review → plan.md
• 2026-09-01 12:53:17+08:00 — Review Plan (Round 1) [started] by codex — started
• 2026-09-01 12:57:43+08:00 — Review Plan (Round 1) by codex — Verdict: Changes Requested, blockers: 0, major: 2, minor: 0, Manual-validation: 0 → review-plan.md
• 2026-09-01 14:02:57+08:00 — Review Plan (Round 2) [started] by codex — started
• 2026-09-01 14:05:33+08:00 — Review Plan (Round 2) by codex — Verdict: Changes Requested, blockers: 0, major: 2, minor: 0, Manual-validation: 0 → review-plan-r2.md
• 2026-09-01 14:07:26+08:00 — Plan Task (Round 2) [started] by codex — started
• 2026-09-01 14:11:02+08:00 — Plan Task (Round 2) by codex — Plan completed, awaiting human review → plan-r2.md
• 2026-09-01 14:15:16+08:00 — Review Plan (Round 3) [started] by codex — started
• 2026-09-01 14:19:25+08:00 — Review Plan (Round 3) by codex — Verdict: Changes Requested, blockers: 0, major: 1, minor: 0, Manual-validation: 0 → review-plan-r3.md
• 2026-09-01 14:21:03+08:00 — Plan Task (Round 3) [started] by codex — started
• 2026-09-01 14:28:09+08:00 — Plan Task (Round 3) by codex — Plan completed, awaiting human review → plan-r3.md
• 2026-09-01 14:32:46+08:00 — Review Plan (Round 4) [started] by codex — started
• 2026-09-01 14:35:30+08:00 — Review Plan (Round 4) by codex — Verdict: Approved, blockers: 0, major: 0, minor: 0, Manual-validation: 0 → review-plan-r4.md
• 2026-09-01 14:38:08+08:00 — Code Task (Round 1) [started] by codex — started
• 2026-09-01 15:06:55+08:00 — Commit by codex — fda663a1 fix: enforce safe issue comment content
• 2026-09-01 15:07:09+08:00 — Code Task (Round 1) by codex — Code implemented, 13 files modified, 2715 tests passed → code.md
• 2026-09-01 15:14:36+08:00 — Review Code (Round 1) [started] by codex — started
• 2026-09-01 15:40:00+08:00 — Review Code (Round 1) by codex — Verdict: Changes Requested, blockers: 0, major: 3, minor: 0, Manual-validation: 0 → review-code.md
• 2026-09-01 17:01:03+08:00 — Code Task (Round 2, fix for review-code.md) [started] by codex — started
• 2026-09-01 17:20:48+08:00 — Commit by codex — 3cc2c675 fix(task-comments): preserve safe link contexts
• 2026-09-01 17:25:25+08:00 — Code Task (Round 2, fix for review-code.md) by codex — Fixed 0 blockers, 3 major, 0 minor issues → code-r2.md
• 2026-09-01 17:29:55+08:00 — Review Code (Round 2) [started] by codex — started
• 2026-09-01 17:39:21+08:00 — Review Code (Round 2) by codex — Verdict: Changes Requested, blockers: 0, major: 2, minor: 0, Manual-validation: 0 → review-code-r2.md
• 2026-09-01 17:47:20+08:00 — Commit by codex — 1e1d208e fix(task-comments): tighten HTML and temporary-path detection
• 2026-09-01 17:49:22+08:00 — Code Task (Round 3, fix for review-code-r2.md) [started] by codex — started
• 2026-09-01 17:50:36+08:00 — Code Task (Round 3, fix for review-code-r2.md) by codex — Fixed 0 blockers, 2 major, 0 minor issues → code-r3.md
• 2026-09-01 17:55:59+08:00 — Review Code (Round 3) [started] by codex — started
• 2026-09-01 18:02:11+08:00 — Review Code (Round 3) by codex — Verdict: Changes Requested, blockers: 0, major: 1, minor: 0, Manual-validation: 0 → review-code-r3.md
• 2026-09-01 19:41:16+08:00 — Human Decision by human — CD-4 decided → HDR-3
• 2026-09-01 19:44:06+08:00 — Code Task (Round 4, fix for review-code-r3.md) [started] by codex — started
• 2026-09-01 19:56:21+08:00 — Commit by codex — 81ff0570 fix(task-comments): preserve source content policy
• 2026-09-01 19:58:29+08:00 — Code Task (Round 4, fix for review-code-r3.md) by codex — Fixed 0 blockers, 1 major, 0 minor issues → code-r4.md
• 2026-09-01 20:36:06+08:00 — Review Code (Round 4) [started] by codex — started
• 2026-09-01 20:45:15+08:00 — Review Code (Round 4) by codex — Verdict: Changes Requested, blockers: 0, major: 1, minor: 0, Manual-validation: 0 → review-code-r4.md

完成检查清单

• 所有需求已满足
• 测试已编写并通过
• 代码已审查
• 文档已更新（如适用）
• PR 已创建

产物生命周期收据

event	output	input	input_sha256	completed_at
review-analysis.completed	review-analysis.md	analysis.md	97fcedfccf6055b5e944e74cf861475b4953b21c973552c229125c9528a3a1b8	2026-09-01 00:19:49+08:00
review-analysis.completed	review-analysis-r2.md	analysis-r2.md	768c50cc4abf90b67c74139beaaa8192d648da00658dc88fbe42a77523df5f0e	2026-09-01 11:22:36+08:00
review-plan.completed	review-plan.md	plan.md	40921ec8e900f13eeb51dc1290bee3efba7dcbebda87f7d719fe68168756933b	2026-09-01 12:57:43+08:00
review-plan.completed	review-plan-r2.md	plan.md	40921ec8e900f13eeb51dc1290bee3efba7dcbebda87f7d719fe68168756933b	2026-09-01 14:05:33+08:00
review-plan.completed	review-plan-r3.md	plan-r2.md	e0bee301ebca4441acf63443a39ef674a739debf6a2789393669ae9ea1dd92db	2026-09-01 14:19:25+08:00
review-plan.completed	review-plan-r4.md	plan-r3.md	e483241a7a164dcc43d6eefc593a977c015ea6426f359464bac9da3bc8b3214c	2026-09-01 14:35:30+08:00
code.completed	code.md	plan-r3.md	e483241a7a164dcc43d6eefc593a977c015ea6426f359464bac9da3bc8b3214c	2026-09-01 15:07:09+08:00
review-code.completed	review-code.md	code.md	f842196b4d35509dbfd1fdb0e9ca3be31e3f048308ddd5e1dedf5c05bd845309	2026-09-01 15:40:00+08:00
code.completed	code-r2.md	plan-r3.md	e483241a7a164dcc43d6eefc593a977c015ea6426f359464bac9da3bc8b3214c	2026-09-01 17:25:25+08:00
review-code.completed	review-code-r2.md	code-r2.md	3448eb18e788d2da1da0eee5717a89675567f01b0a6cd449ac09ab7bc99e033b	2026-09-01 17:39:21+08:00
code.completed	code-r3.md	plan-r3.md	e483241a7a164dcc43d6eefc593a977c015ea6426f359464bac9da3bc8b3214c	2026-09-01 17:50:36+08:00
review-code.completed	review-code-r3.md	code-r3.md	2b3b6cfaa2f8630b7a7e82b95ba54aa4490762cc6e6bef480597d1f1c8a8ae77	2026-09-01 18:02:11+08:00
code.completed	code-r4.md	plan-r3.md	e483241a7a164dcc43d6eefc593a977c015ea6426f359464bac9da3bc8b3214c	2026-09-01 19:58:29+08:00
review-code.completed	review-code-r4.md	code-r4.md	750e0b0771aff9e5e8f5e139ef2018d4603d40d9f2208af0914ab8993a5a558d	2026-09-01 20:45:15+08:00

---

由 codex 自动生成 · 内部追踪：TASK-20260826-184851

[CodeCasterX]

需求分析（Round 1）

codex · TASK-20260826-184851

需求分析报告

• 分析轮次：Round 1
• 产物文件：analysis.md

状态核对

$ git status -s
(empty)
$ ls -la .agents/workspace/active/TASK-20260826-184851/
f	7518	task.md
$ tail .agents/workspace/active/TASK-20260826-184851/task.md
- 2026-08-26 18:48:51+08:00 — **Create Task** by codex — Task created from structured candidate

## 完成检查清单

- [ ] 所有需求已满足
- [ ] 测试已编写并通过
- [ ] 代码已审查
- [ ] 文档已更新（如适用）
- [ ] PR 已创建
<!-- 由 complete-task 勾选 -->

需求来源

来源类型：用户描述、前序链接审计及代码核对结果

来源摘要：

修复同步到 GitHub Issue 的任务文件和生命周期产物中的错误超链接。同步范围内的本地产物引用使用反引号代码文本，避免 GitHub 将相对路径解析为 Issue 下的错误地址；非用户语义的 @2x 等文本也使用代码格式，避免被识别为用户提及。任务已确认本地 Markdown 与远端评论使用同一套表示规则，并要求保留正式文档及有效 Issue、PR、commit、外部链接。

需求理解

本任务治理的是“会进入 Issue 评论的任务内容”这一同步边界：

1. 生命周期自动追加到 task.md 的产物引用不再生成 Markdown 相对链接，而生成不可点击的代码文本；该规则需要覆盖分析、审查、方案、实现、验证及 PR 审查等纳入 artifact catalog 的产物。
2. 产物正文中的同类本地 workspace、临时任务文件、任务分支文件或明显易失效的本地路径不能继续以会被 GitHub 解析的链接形式进入 Issue artifact 评论。
3. 非用户语义的 @2x 等文本必须避免 GitHub 自动转换为用户链接；已经确认有效的用户、Issue、PR、commit 和外部链接不应被误改。
4. task 评论和 artifact 评论仍发布本地 Markdown 的业务正文，不能由同步层单独改写成另一种远端格式；内容校验、marker、分片、幂等更新和删除陈旧分片的既有契约应继续有效。

本轮不把历史 Issue 评论批量修复或处理账号已改名、删除、不可访问的真实用户提及默认为需求，分别登记为人工裁决项。

相关文件

• lib/task/artifact-lifecycle.ts:12-22 - 定义所有生命周期 artifact family；lib/task/artifact-lifecycle.ts:473-501 当前把产物引用生成为 [label](artifact.md) 并写回 task.md。
• lib/task/events.ts:419-505 - 各生命周期 completed 事件校验产物并调用 buildArtifactLinkSection，因此是自动引用进入 task.md 的主要入口。
• lib/task/activity-intent.ts:302-365 - PR review 完成路径也调用同一产物引用生成逻辑，需纳入覆盖范围。
• lib/platform/issue-comments.ts:60-75 - task 评论封装 frontmatter 与 task.md 正文；lib/platform/issue-comments.ts:212-254 - artifact、summary、cancel 评论正文封装；lib/platform/issue-comments.ts:308-430 - 读取本地正文、按 marker 幂等同步并处理分片。
• lib/platform/verification-sync.ts:604-664 - 平台校验比较 Issue 上的 task/artifact 评论正文与本地内容；lib/platform/verification-sync.ts:908-977 - 提取评论正文并重建 task frontmatter 期望格式。
• lib/task/commands/issue-body.ts:29-36 - 初始 Issue body 只抽取任务输入、描述和需求，属于 Issue 创建正文边界，不应因本任务误改正式文档或非评论链接。
• tests/unit/platform/issue-comments.test.ts:19-73 - task/artifact 评论渲染、分片和回填的单元覆盖；tests/unit/platform/issue-comments.test.ts:125-153 - 评论同步幂等性覆盖。
• tests/integration/cli/platform-comment.test.ts:43-87 - 内部评论同步命令及 task 评论中 artifact receipt 的集成覆盖。
• tests/integration/cli/task-event.test.ts:630-652、:717-735 - 当前生命周期完成测试明确断言自动生成的 .md 相对链接。
• tests/e2e/core/validate-artifact-platform-sync.test.ts:165-220 - 验证本地 task/artifact 内容与远端评论内容相等，以及内容不一致时失败。

影响评估

直接影响：

• 生命周期完成事件和 PR review 活动意图写入 task.md 的产物引用表示。
• platform-comment sync --kind task|artifact 发送的同步正文及其内容约束/校验边界。
• 覆盖自动产物引用、手写 artifact 正文、@2x 类非用户文本的单元、集成和平台同步回归测试。

间接影响：

• verification-sync 的本地/远端正文相等性检查；如果表示规则只在同步时转换，会造成校验失败，因此本地生成与远端发布必须共享同一结果。
• artifact review input 的代码格式引用（如 `plan.md`）及 receipt 解析；这些是生命周期身份数据，不能因链接治理被误判为普通展示链接。
• 任务目录中的非 artifact 正式文档、README 和有效仓库链接。它们不在本任务同步范围内，应保持现状。
• 现有 task-event 测试中的旧链接断言需要改为新的可观察行为断言；测试不得通过自然语言关键词推断文档正确性。

技术风险

• 边界识别过宽：粗略替换所有 Markdown 链接或所有 @ 文本可能破坏有效仓库文档链接、Issue/PR/commit/外部 URL 或真实用户提及。方案阶段需要限定为同步范围、明确的本地 artifact/workspace 路径和已确认的非用户 token。
• 仅改同步层会破坏一致性：platform-comment 当前读取并封装本地正文，verification-sync 又比较本地与远端正文；只改 GitHub payload 会留下本地/远端差异，不能满足任务约束。
• 入口遗漏：自动引用至少由普通 task event 和 PR review activity intent 两条路径生成；只改其中一处会在后续阶段重新产生相对链接。手写 artifact 也可能携带同类路径，需要明确校验或生成边界。
• Markdown 语法误判：链接文本可能出现在代码围栏、行内代码、表格、HTML 或转义内容中；@2x 也可能是版本/图片清晰度术语。处理规则需要保护代码语义并避免改变结构化 receipt/reference 的可解析格式。
• 历史远端副作用：批量编辑已发布评论会产生外部共享状态变化，且无法由当前任务输入确定历史评论的完整范围；在人工裁决前按 current-only 处理。
• 网络与账号状态依赖：判断真实用户提及是否失效可能需要 GitHub 查询，并受权限、速率限制和账号可见性影响；不能让这类不确定性掩盖当前确定的 @2x 类问题。

依赖关系

• 依赖 artifact family catalog 和生命周期事件的 canonical artifact identity，保持 round、receipt、review input 的现有语义不变。
• 依赖 platform-comment 的 task/artifact marker、UTF-8 分片、幂等更新和 warning 错误分类；链接治理不能改变评论身份或分片边界契约。
• 依赖 verification-sync 的正文提取和相等性检查，新增行为需要同时验证本地 task/artifact 与模拟远端评论的结果。
• 依赖现有 Node.js node:test 测试层级和 npm test 的 build-first 流程；当前分析不执行业务代码修改或测试实现。
• 不新增历史格式兼容层：根据 compatibility policy，本任务已有的 current-only 约束不足以支持旧评论双写、同步回退或长期 shim。

假设

• 本轮只分析未来生成和同步的当前契约；历史 Issue 评论不自动回填，除非人工裁决明确扩大范围。
• 用户已确认的规则优先：同步范围内的本地产物引用采用代码文本，不引入固定 commit permalink 作为默认替代。
• 正式项目文档中的有效相对链接不属于本任务；只有进入任务评论同步边界的 task/artifact Markdown 才需要治理。
• 真实用户提及默认保留其原有语义；本轮确定处理的是明显非用户语义的 @2x 类文本，账号状态相关范围等待人工裁决。

未决问题

• 是否批量回填已经发布到历史 Issue 评论中的错误链接，详见 HD-1。
• 是否把账号改名、删除或不可访问的真实用户提及纳入本任务，详见 HD-2。

人工裁决待办

HD-1：历史 Issue 评论是否批量回填 [needs-human-decision]

• 要决定什么：本任务是否要修改已经发布的历史 Issue task/artifact 评论中的错误本地链接。
• 为什么现在要决定：当前代码可以约束未来生成和同步的正文，但任务输入没有给出历史评论的完整清单、时间范围或可逆发布窗口。批量编辑会直接改变 GitHub 上的共享记录，不能作为默认实现细节处理。
• 会影响什么：会影响 platform-comment backfill 或其他远端评论操作的范围、权限与测试；不选择回填则只保证之后生成的 task.md 和 artifact 评论符合当前规则。
• 如果选错或暂不处理：选择回填可能误改不属于本任务的评论或造成大量远端写入；不回填则历史评论仍可能保留错误链接，但未来内容不会继续产生同类问题。

方案 A：仅修复未来内容

• 实际会怎么做：只修改当前生成/同步契约和对应校验；不扫描、不编辑已有 Issue 评论，历史错误保留原样。
• 选了以后会怎样：新发布或重新同步的评论使用当前规则，既有评论不会改变；如未来确需整理历史记录，可另建有明确清单和窗口的任务。
• 好处：范围最小、不会产生未经确认的远端批量副作用，也与当前任务已确认的本地/远端一致性目标直接匹配。
• 代价：历史 Issue 仍可能显示旧的错误链接，需要人工另行处理。
• 例子/类比：像把“以后寄出的信”统一改用正确地址，但不擅自打开并重写已经寄出的整箱旧信。

方案 B：批量回填历史评论

• 实际会怎么做：按选定的 Issue、评论 marker、时间或 artifact 范围读取旧评论，替换其中符合规则的本地链接，并保留 marker、分片和其他正文。

• 选了以后会怎样：历史评论也会被改成不可点击代码文本，但需要处理权限、分页、重复 marker、失败重试和部分成功恢复。

• 好处：远端历史视图更一致，用户不再看到已知的旧错误链接。

• 代价：会扩大任务范围并修改外部共享数据；没有明确范围时容易误改，且需要额外的回填验证和恢复策略。

• 例子/类比：像重新打开旧信件逐封改地址，结果更整齐，但必须先确定哪些信件属于这次整理并记录每次改动。

• 建议选哪个：方案 A。

• 为什么这样建议：当前输入只明确了未来规则，没有提供可安全批量回填所需的对象、必要性、期限和退出条件；按 current-only 可完成确定目标且保持外部副作用最小。

HD-2：是否处理已失效的真实用户提及 [needs-human-decision]

• 要决定什么：本任务是否要把账号改名、删除或不可访问的真实用户提及也转换为代码文本。
• 为什么现在要决定：@2x 这类非用户语义文本已明确需要防止 GitHub 自动识别，但“真实用户提及失效”需要平台身份查询，且失效不等于原文没有业务意义。任务输入没有规定查询时点、权限失败时的行为或哪些历史/未来内容属于处理范围。
• 会影响什么：会影响 task/artifact Markdown 的清理边界、是否引入 GitHub 用户状态查询、网络失败处理及对已有署名/归因文本的保留方式。
• 如果选错或暂不处理：扩大处理可能把有意保留的历史归因改成普通代码；缩小处理则可能让失效的真实提及继续成为不可用链接，但不会影响已确认的 @2x 类修复。

方案 A：只处理明确的非用户 token

• 实际会怎么做：对已确认的 @2x 等明确非用户语义模式进行代码化处理；保留看起来像真实账号的提及，不查询其当前可访问性。
• 选了以后会怎样：未来同步内容不会把 @2x 误发布为用户链接，但账号状态变化由原文继续表达，后续可单独制定身份清理任务。
• 好处：行为确定、无需依赖 GitHub 账号查询，也不会因权限或账号可见性改变而产生不稳定结果。
• 代价：失效账号提及可能继续显示为失效链接。
• 例子/类比：像把“图片 2 倍清晰度”的 @2x 当作型号标签贴起来，但不因为通讯录暂时查不到某个人就改写他的署名。

方案 B：连失效的真实提及一起代码化

• 实际会怎么做：同步或生成时识别用户提及并查询账号状态；确认账号失效后改成代码文本，同时定义查询失败、账号私有和批量历史内容的处理方式。

• 选了以后会怎样：Issue 中失效账号不再显示为可点击用户链接，但输出依赖平台状态和额外网络/权限路径。

• 好处：远端展示更少出现失效用户链接，能覆盖比 @2x 更广的易失效链接问题。

• 代价：识别与查询成本更高，可能误判、受速率限制影响，并改变原本有意保留的历史归因文本。

• 例子/类比：像每次寄信前都实时查通讯录并把查不到的人名改成普通文字，显示更干净，但通讯录临时不可用时不能确定该怎么改。

• 建议选哪个：方案 A。

• 为什么这样建议：当前需求已经给出可确定的非用户 token 示例，而没有提供平台身份查询的稳定契约；先按明确语义处理可以避免把外部账号状态引入本地内容生成主路径。

工作量和复杂度评估

• 复杂度：中
• 风险等级：高

---

由 codex 自动生成 · 内部追踪：TASK-20260826-184851

[CodeCasterX]

需求分析审查（Round 1）

codex · TASK-20260826-184851

需求分析审查报告

• 审查轮次：第 1 轮
• 产物文件：review-analysis.md
• 审查输入：
  • analysis.md

状态核对

$ git status -s
(empty)
$ ls -la .agents/workspace/active/TASK-20260826-184851/
f	14000	analysis.md
f	7937	task.md
$ tail .agents/workspace/active/TASK-20260826-184851/task.md
- 2026-09-01 00:08:31+08:00 — **Analyze Task (Round 1)** by codex — Analysis completed → analysis.md

## 完成检查清单

- [ ] 所有需求已满足
- [ ] 测试已编写并通过
- [ ] 代码已审查
- [ ] 文档已更新（如适用）
- [ ] PR 已创建
<!-- 由 complete-task 勾选 -->

审查摘要

• 审查者：codex
• 审查时间：2026-09-01 00:15:11+08:00
• 审查范围：2 个任务产物（task.md、analysis.md）及 8 个被引用的核心/测试文件区域
• 总体结论：需要修改
• 结论依据：分析内容可追踪且足以支持后续设计，但 2 项范围决策仍待人工裁决，阶段门禁不能放行
• 发现（AI 可处理）：0 阻塞项，0 主要，0 次要 / 人工校验：0

检视覆盖声明

pass_id	scope	evidence	result	gaps_or_assumptions
pass-1	原始任务输入、验收标准、最新分析产物及被引用代码	task.md:23-77；analysis.md:26-158；lib/task/artifact-lifecycle.ts:473-501；lib/platform/issue-comments.ts:60-74,212-254	独立核实自动相对链接生成、本地正文原样进入评论、正文一致性约束与现有测试锚点；未发现与来源冲突	未直接访问前序对话或真实 GitHub 评论，仅使用 task.md 已记录事实作为来源边界
pass-2	来源到范围、验收、影响、风险与开放问题的追踪	task.md:33-77；analysis.md:33-99,155-158；下方追踪矩阵	已确认目标、非目标、受影响入口、测试位置与两项未决范围均可追踪	任务没有关联 Issue，无法补充远端 Issue 上下文
pass-3	分析阶段风险镜头与角色/质量/演进专项覆盖	.agents/rules/review-method.md 风险注册表；.agents/rules/compatibility-policy.md；下方风险镜头和专项覆盖表	compatibility-budget 命中并已加载；分析采用 current-only，历史回填没有被默认为兼容义务	code-only 风险镜头不适用于本阶段
pass-4	对候选问题与放行结论进行反证	analysis.md:37-42,46-87,103-153；task.md:66-77；`rg -n "buildArtifactLinkSection	\]\([^)]*\.md\)	@2x" ...`
pass-5	finding、人工校验、人工裁决、摘要与 verdict 收敛	task.md:117-124；analysis.md:96-153；本报告问题清单	0 个 AI finding、0 个人工校验；HD-1/HD-2 保持 needs-human-decision，因此结论为需要修改	必须由人工裁决后重新执行分析与审查，不能直接进入方案阶段

lens_id	trigger_evidence	loaded	result
compatibility-budget	任务改变既有相对链接写入行为，并明确讨论历史评论：task.md:42-46,76-77、analysis.md:78,87,91	yes	分析明确 current-only；未新增双写、旧格式回退或长期 shim。历史回填作为 HD-1 独立裁决，符合兼容预算边界
documentation-antipatterns	注册表限定 code 阶段；本轮只审查分析产物，没有代码变更	not-applicable	不适用
testing-discipline	注册表限定 code 阶段；本轮只评估测试输入，不修改测试	not-applicable	不适用
security-risks	注册表限定 code 阶段；本轮安全视角在专项覆盖表中审查	not-applicable	不适用
migration-risks	注册表限定 code 阶段；分析未设计 schema 或迁移实现	not-applicable	不适用
concurrency-risks	注册表限定 code 阶段；分析未改变异步协调实现	not-applicable	不适用
cross-platform-risks	注册表限定 code 阶段；路径示例的跨平台边界已作为需求证据审查，尚无代码变更	not-applicable	不适用

需求分析专项覆盖

perspective_id	applicability	reviewed_scope	evidence	result_or_gap
user	applicable	错误链接、@2x 展示结果、本地/远端一致性、非目标与验收	task.md:23-77；analysis.md:26-42,89-99	covered
maintainer	applicable	生成入口、artifact catalog、同步边界、兼容性与长期责任	analysis.md:44-55,65-87；lib/task/artifact-lifecycle.ts:12-22,473-501	covered
operations	applicable	评论同步、分片、幂等、验证、远端回填与网络/权限约束	analysis.md:40,49-50,67,78-85,103-127	covered
security	applicable	用户提及身份边界、平台查询权限与误改归因风险	analysis.md:74,77,79,129-153	covered
testing	applicable	可观察输入、生成/同步动作、保持与拒绝结果、验证环境	task.md:66-72；analysis.md:52-55,63,70,83-86	covered

quality_id	source	stakeholder	priority_or_tradeoff	verification	result_or_gap
Q-PARITY	SRC-CONSTRAINTS	user, operations	必须：本地业务正文与远端评论使用同一表示规则	生成本地 task/artifact 后同步，比较提取后的远端正文与本地正文	covered
Q-PRECISION	SRC-ACCEPTANCE	user, maintainer	高：阻止错误本地链接和非用户提及，同时保留有效链接/真实提及	以危险本地路径、@2x、有效仓库/Issue/PR/commit/外链及真实提及构造正反例	covered
Q-RELIABILITY	SRC-FACTS	operations, maintainer	必须保持 marker、分片、幂等更新和正文验证契约	运行现有评论单元、命令集成和 platform-sync e2e，并补充新行为用例	covered

evolution_id	source	confirmation_status	classification	boundary_evidence	result_or_gap
EV-HISTORICAL-COMMENTS	SRC-OPEN	unconfirmed	open-question	task.md:76；analysis.md:103-127 明确不把历史回填扩张为当前需求	covered
EV-ACCOUNT-STATE	SRC-OPEN	unconfirmed	open-question	task.md:77；analysis.md:129-153 明确不把账号状态查询扩张为当前需求	covered

acceptance_id	observable_input	action	expected_result	status_or_gap
AC-AUTO-REF	完成任一 canonical 生命周期产物	检查本地 task.md，并渲染/sync task 评论	产物文件名以代码文本呈现且不可点击；本地与远端业务正文一致	verifiable
AC-ARTIFACT-PATH	artifact 正文包含 workspace、用户目录或临时任务文件引用	执行内容约束并渲染/sync artifact 评论	不产生指向 Issue 相对地址、/workspace/、/Users/ 或临时任务文件的错误链接	verifiable
AC-MENTION	正文包含非用户语义 @2x	生成并渲染/sync 评论	token 以代码文本呈现，不成为用户主页链接	verifiable
AC-PRESERVE	正文包含有效项目文档相对链接、Issue、PR、commit、外部链接或真实用户提及	运行同一生成/校验路径	有效链接和真实提及保持原语义，不被泛化替换	verifiable
AC-REGRESSION	完成上述正反例实现	运行结构性测试与 npm test	新用例和完整项目测试通过，且不使用文案关键词语义断言	verifiable

追踪矩阵

source_id	upstream	reviewed_target	verification	status_or_gap
SRC-USER	task.md:33-38 用户请求与三项确认	analysis.md:26-42 的目标、范围与非目标	逐项对照本地引用代码化、@2x 代码化、本地/远端同规则	covered
SRC-FACTS	task.md:40-46 已核实行为	analysis.md:44-55,65-70 的文件与间接影响	nl -ba lib/task/artifact-lifecycle.ts ...、nl -ba lib/platform/issue-comments.ts ...、nl -ba lib/platform/verification-sync.ts ...	covered
SRC-CONSTRAINTS	task.md:48-52 同源正文与同步范围	analysis.md:35-40,67-70,74-77 的边界和风险	对照 issue-comments.ts:60-74,212-254 与 verification-sync.ts:604-664	covered
SRC-DECISIONS	task.md:54-64 已确认及否决方案	analysis.md:37-42,87,92-94 的 current-only 和表示规则	对照兼容性策略及任务已确认决策	covered
SRC-ACCEPTANCE	task.md:66-72 五项验收	本报告 AC-AUTO-REF 至 AC-REGRESSION，以及 analysis.md:52-55,61-70,83-86	可定位单元、集成与 e2e 测试入口	covered
SRC-OPEN	task.md:74-77 两项未决范围	analysis.md:96-153 的 HD-1/HD-2	逐项核对自足结构、方案、影响、例子与建议	covered；等待人工裁决

问题清单

阻塞项（必须修复）

（无）

主要问题（建议修复）

（无）

次要问题（低影响但需闭环）

（无）

非阻塞建议

（无）

人工校验项

（无）

审查分歧账本回写

• 本轮没有新增 AI finding，不调用 finding-upsert。
• 已复核现有 HD-1 与 HD-2：两项详情均满足自足结构，且任务输入尚未给出裁决，因此保持 needs-human-decision，不伪造 finding-review 或人工裁定。

证据原文

• 断言：生命周期核心的统一生成点当前写入 Markdown 相对链接。

$ nl -ba lib/task/artifact-lifecycle.ts | sed -n '473p;482,487p;498,501p'
   473	function buildArtifactLinkSection(content: string, artifact: ArtifactIdentity): {
   482	  const label = english
   483	    ? `${spec.labels[1]} (Round ${artifact.round})`
   484	    : `${spec.labels[0]}（Round ${artifact.round}）`;
   485	  const link = `[${label}](${artifact.name})`;
   486	  let body = extractSection(content, aliases);
   487	  if (body.includes(`](${artifact.name})`)) return { aliases, heading, body };
   498	  if (placeholder >= 0) lines[placeholder] = link;
   499	  else lines.push(...(body ? ['', link] : [link]));
   500	  body = lines.join('\n').replace(/^\n+|\n+$/g, '');
   501	  return { aliases, heading, body };

• 断言：task 与 artifact 评论分别使用本地 task.md 正文和 artifact 文件原文，不存在同步层业务正文改写。

$ nl -ba lib/platform/issue-comments.ts | sed -n '60p;71p;74p;212p;214p;218p;227p;236,237p;246p'
    60	function renderTaskComment(content: string, taskId: string, agent: string): string {
    71	    taskBody.replace(/\n+$/, ''),
    74	  ].join('\n'));
   212	function bodyEnvelope(marker: string, title: string, taskId: string, agent: string, body: string): string {
   214	    marker, `## ${title}`, '', `> **${agent}** · ${taskId}`, '', body.replace(/\n+$/, ''), '', footer(agent, taskId)
   218	function resolveArtifactBody(taskDir: string, artifact: string): string {
   227	  return fs.readFileSync(realArtifact, 'utf8');
   236	  if (options.kind === 'task') {
   237	    const body = renderTaskComment(taskContent, taskId, options.agent);
   246	      body: resolveArtifactBody(taskDir, options.artifact),

• 断言：现有平台验证以本地/远端正文相等作为门禁，支持分析中的同源规则约束。

$ nl -ba lib/platform/verification-sync.ts | sed -n '620,624p;639p;653,656p'
   620	  const comment = findCommentByMarker(remoteData.comments, context.marker);
   621	  const localContent = normalizeContent(fs.readFileSync(context.artifactPath, "utf8"));
   622	  const commentContent = normalizeContent(extractCommentBody(comment?.body || ""));
   624	  if (localContent === commentContent) {
   639	function checkTaskCommentContent(context: any, remoteData: any): any {
   653	  const expectedBody = normalizeContent(buildExpectedTaskBody(context.task.content));
   654	  const commentBody = normalizeContent(extractCommentBody(comment.body || ""));
   656	  if (expectedBody === commentBody) {

• 断言：相关生成入口只有统一 helper 的普通事件与 PR review 调用点；仓库中其他 .md 相对链接命中位于归档 manifest 生成，不属于任务评论 artifact 生命周期。

$ rg -n "buildArtifactLinkSection|\]\([^)]*\.md\)|@2x" lib tests .agents/skills --glob '*.ts' --glob '*.md' | head -220
lib/merge.ts:356:        `| ${month} | ${monthCounts.get(`${year}\t${month}`)} | [${month}/manifest.md](${month}/manifest.md) |`
lib/merge.ts:371:      `| ${year} | ${yearCounts.get(year)} | [${year}/manifest.md](${year}/manifest.md) |`
lib/task/activity-intent.ts:8:  buildArtifactLinkSection,
lib/task/activity-intent.ts:364:    const link = buildArtifactLinkSection(state.content, roundState.identity);
lib/task/artifact-lifecycle.ts:473:function buildArtifactLinkSection(content: string, artifact: ArtifactIdentity): {
lib/task/artifact-lifecycle.ts:508:  assertWritableInventory, validateCompletedArtifact, buildArtifactLinkSection
lib/task/events.ts:5:  buildArtifactLinkSection,
lib/task/events.ts:504:    const link = buildArtifactLinkSection(content, completedArtifact);

• 断言：两项待裁决在任务账本中仍为当前分析阶段的非终态，且证据锚点与分析报告一致。

$ nl -ba .agents/workspace/active/TASK-20260826-184851/task.md | sed -n '117p;121,124p'
   117	## 审查分歧账本
   121	| id | stage | round | severity | status | evidence |
   122	|----|-------|-------|----------|--------|----------|
   123	| HD-1 | analysis | - | decision | needs-human-decision | analysis.md#HD-1 |
   124	| HD-2 | analysis | - | decision | needs-human-decision | analysis.md#HD-2 |

自我质疑

• 本轮没有在真实 GitHub Issue 上重新验证 @2x 的自动链接渲染；任务没有绑定 Issue，且该行为已经以“已核实事实”写入 task.md:45。若该来源事实被推翻，AC-MENTION 的必要性会改变，但不会影响本报告对分析与任务来源一致性的判断。
• rg 结果只证明当前仓库内显式的统一 helper 调用点，不能证明未来手写 artifact 不会产生任意 Markdown 链接；分析已把手写内容约束列为方案输入和测试范围，因此没有把这一限制误写成“已自动解决”。

亮点

• 分析将普通生命周期事件和 PR review 两条自动引用入口收敛到同一个 helper，避免把共享生成点误判为两个独立实现问题。
• 对 current-only、本地/远端正文一致性、有效链接保留和 marker/分片/幂等契约的边界说明清晰。
• HD-1 与 HD-2 均完整说明选择、影响、代价、例子与建议，没有用内部术语替代业务解释。

与方案一致性

• 当前尚未进入方案/实现阶段，本轮未提前锁定架构或实现技术
• 没有把历史回填或账号状态查询意外扩张为当前需求

结论与建议

审查决定

• 通过
• 需要修改
• 拒绝

下一步

先由维护者裁决 HD-1 与 HD-2；随后重新执行需求分析以吸收裁决并生成下一轮产物，再复审。裁决完成前不得进入技术方案阶段。

---

由 codex 自动生成 · 内部追踪：TASK-20260826-184851

[CodeCasterX]

需求分析（Round 2）

codex · TASK-20260826-184851

需求分析报告

• 分析轮次：Round 2
• 产物文件：analysis-r2.md

状态核对

$ git status -s
(empty)
$ ls -la .agents/workspace/active/TASK-20260826-184851/
f	14000	analysis.md
f	15701	review-analysis.md
f	9589	task.md
$ tail .agents/workspace/active/TASK-20260826-184851/task.md
- [ ] 代码已审查
- [ ] 文档已更新（如适用）
- [ ] PR 已创建
<!-- 由 complete-task 勾选 -->

## 产物生命周期收据

| event | output | input | input_sha256 | completed_at |
| --- | --- | --- | --- | --- |
| review-analysis.completed | review-analysis.md | analysis.md | 97fcedfccf6055b5e944e74cf861475b4953b21c973552c229125c9528a3a1b8 | 2026-09-01 00:19:49+08:00 |

需求来源

来源类型：用户描述、前序链接审计、代码核对结果及人工裁决

来源摘要：

修复同步到 GitHub Issue 的任务文件和生命周期产物中的错误超链接。同步范围内的本地产物引用使用反引号代码文本，避免 GitHub 将相对路径解析为 Issue 下的错误地址；非用户语义的 @2x 等文本也使用代码格式，避免被识别为用户提及。用户已裁决只修复未来生成/同步的内容，不批量回填历史评论；正常生成和同步不查询 GitHub 账号状态，明确的非用户 token 代码化，账号形态但意图不明的提及保留。

对上一轮审查的响应

上一轮 review-analysis.md 的结论为“需要修改”，但没有形成任何 AI finding：0 个 blocker、0 个 major、0 个 minor、0 个人工校验项（review-analysis.md:29-36）。其唯一的阶段阻塞原因是当时 HD-1、HD-2 尚未裁决（review-analysis.md:42-46,215-225）。因此本轮没有可调用 finding-respond 的 ledger finding；原阻塞项通过人工裁决闭环，证据如下：

• HD-1 已在账本中标记为 human-decided，HDR-1 明确选择“仅修复未来生成/同步的内容，不批量回填历史 Issue 评论”（task.md:121-138）。本轮将历史评论批量编辑排除在实现范围之外。
• HD-2 已在账本中标记为 human-decided，HDR-2 明确要求正常生成/同步不查询 GitHub；仅对明确的非用户语义 token 使用代码格式，保留意图不明的账号形态提及；未来账号状态审计必须是独立、只读、只报告且不阻塞同步的动作（task.md:121-132）。本轮将 GitHub 账号查询排除在正常实现路径之外。
• 上一轮已核实的代码入口仍成立：自动 artifact 引用由共享 helper 生成，task/artifact 评论使用本地正文，平台校验比较本地与远端正文（lib/task/artifact-lifecycle.ts:473-501、lib/task/events.ts:419-505、lib/task/activity-intent.ts:302-365、lib/platform/issue-comments.ts:60-74,212-254、lib/platform/verification-sync.ts:604-664）。本轮未发现新的入口或与裁决冲突的现有约束。

需求理解

本任务治理的是“会进入 Issue 评论的任务内容”，目标是让本地生成结果与远端评论保持同一正文表示：

1. 生命周期自动追加到 task.md 的 artifact 引用不再生成 Markdown 相对链接，而使用不可点击的代码文本；普通生命周期完成事件和 PR review 完成路径都必须覆盖。
2. 同步范围内的 artifact 正文不能以链接形式暴露 workspace 路径、用户目录、临时任务文件或其他明显只在本地有效的文件引用。正式项目文档及已经确认有效的仓库、Issue、PR、commit 和外部链接不属于泛化替换范围。
3. 对明确的非用户语义 token（当前已确认示例为 @2x）使用代码格式，避免 GitHub 自动渲染为用户链接；看起来像账号但意图不明的提及保留原文，不根据账号当前是否存在来改写。
4. 正常生成和同步流程不访问 GitHub 用户 API，不把网络、权限或限流状态引入正文生成主路径。未来若需要账号状态判断，应另建独立的只读审计/诊断动作，只报告结果，不修改内容，也不阻塞同步；该动作不属于本任务实现范围。
5. 不扫描或编辑历史 Issue 评论。只约束本轮之后生成或重新同步的内容；历史回填如有需要，应另建带明确对象范围、必要性、时间窗口和退出条件的任务。
6. 不在同步阶段单独改写远端 payload。platform-comment 和 verification-sync 的 marker、分片、幂等更新、陈旧分片删除及正文相等性契约继续有效。

相关文件

• lib/task/artifact-lifecycle.ts:12-22,473-501 - artifact family catalog 及自动追加产物引用的共享 helper；当前仍生成 [label](artifact.md)，是自动链接修复的首要变更入口。
• lib/task/events.ts:419-505 - 生命周期 completed 事件校验产物并调用共享 helper，需覆盖分析、方案、实现、验证及各类审查阶段的完成路径。
• lib/task/activity-intent.ts:302-365 - PR review 完成/终止活动意图调用同一 helper，需确认新表示不会遗漏该入口。
• lib/platform/issue-comments.ts:60-75,212-254,308-430 - task/artifact 评论正文封装、artifact 文件读取、按 marker 幂等同步及分片处理；本任务应保持它发布本地正文的行为，不新增 GitHub 账号查询或同步层改写。
• lib/platform/verification-sync.ts:604-664,908-977 - artifact/task 评论的本地/远端正文一致性检查和 task 正文重建；用于验证同源表示规则。
• lib/task/commands/issue-body.ts:29-36 - 初始 Issue body 的输入边界，不应因本任务误改正式文档或非评论链接。
• tests/unit/platform/issue-comments.test.ts:19-73,125-153 - task/artifact 评论渲染、分片、回填和幂等行为的单元测试入口。
• tests/integration/cli/platform-comment.test.ts:43-87 - 评论同步命令及 task 评论 artifact receipt 的集成覆盖。
• tests/integration/cli/task-event.test.ts:630-652,717-735 - 生命周期完成和 review-code 完成目前断言 .md 相对链接，需要改为新的可观察结果。
• tests/e2e/core/validate-artifact-platform-sync.test.ts:165-220 - 本地 task/artifact 内容与模拟远端评论相等及不一致失败的端到端覆盖。

影响评估

直接影响：

• 自动生命周期引用的文本表示，以及依赖 artifact catalog 的 task.md sections。
• 任务评论和 artifact 评论在同步前的内容约束或校验边界。
• 自动 artifact 引用、手写 artifact 正文、非用户语义 @2x 的单元、集成和平台同步回归测试。

间接影响：

• verification-sync 的正文相等性门禁；任何只在同步 payload 中转换的方案都会造成本地/远端不一致，应排除。
• artifact identity、round、receipt 和 review input 解析；代码文本不能破坏这些结构化内容的既有格式。
• marker、UTF-8 分片、幂等更新及陈旧分片清理；链接治理不应改变评论身份或分片生命周期。
• 正式 README、归档 manifest 以及已确认有效的链接；它们不在任务评论同步边界，不应被顺手清理。
• 历史远端评论和 GitHub 用户状态不会被当前任务修改或查询，避免产生额外外部副作用和不稳定依赖。

技术风险

• 本地链接识别过窄：只改自动 helper 可能遗漏手写 artifact 正文中的 workspace、用户目录或临时任务引用。方案阶段需要明确同步范围内的允许/拒绝模式，并用正反例验证。
• 本地链接识别过宽：粗略替换所有 Markdown 链接会破坏有效仓库文档、Issue/PR/commit 或外部链接；不能把正式文档中的相对链接当作任务评论问题处理。
• @ 处理误伤：泛化地转义所有 @ 会改变真实用户提及、邮箱或业务文本。应只覆盖已经明确具有非用户语义的 token 模式，账号形态但意图不明的提及按 HDR-2 保留。
• Markdown 结构误判：链接或 @2x 可能位于行内代码、代码围栏、表格、HTML 或 receipt/reference 内容中。方案阶段需要保护已有代码语义和结构化解析，不以自然语言关键词作测试门禁。
• 同步层改写造成漂移：只修改 GitHub payload 会使本地正文和远端正文不相等；生成、存储、发布和校验必须共享最终表示。
• 外部状态依赖：GitHub 用户查询会引入认证、权限、网络、限流、账号可见性和状态变化问题。HD-2 已裁决正常路径不查询；未来审计只能独立、只读、非阻塞。
• 历史副作用：批量编辑既有 Issue 评论会扩大范围并改变共享记录。HD-1 已裁决 current-only，本任务不得加入扫描或回填流程。

依赖关系

• 依赖 artifact family catalog 和 canonical artifact identity，保持 round、receipt、review input 的现有语义。
• 依赖 platform-comment 的 marker、分片、幂等更新和错误分类；新规则不能改变评论同步状态机。
• 依赖 verification-sync 的正文提取和相等性比较，以相同本地源文件验证模拟远端评论。
• 依赖 Node.js node:test 和项目现有 build-first 测试流程；实现后应运行相关测试及 npm test。
• 不依赖 GitHub 用户 API，也不引入历史评论回填、旧格式双写、同步回退或长期兼容 shim；这与两项人工裁决及 compatibility policy 一致。

假设

• 本轮分析和后续实现只覆盖未来生成/同步内容；历史评论保留现状。
• 明确的非用户 token 以 @2x 为当前验收代表；不能从一个示例推导为“所有 @ 文本都应代码化”。
• 账号形态但意图不明的提及保留原文，不因无法确认账号状态而失败；正常同步不执行 GitHub 查询。
• 未来只读账号审计若要建立，必须作为独立诊断能力设计，不作为本任务的隐藏实现或完成门禁。
• 正式项目文档和归档 manifest 的有效相对链接不属于 Issue 评论治理范围。
• 当前任务无有效 issue_number，因此本轮不会执行远端 Issue 或评论同步；已有 WW-1 仍记录 Issue 创建失败告警。

未决问题

本轮没有剩余的范围裁决项。历史回填和 GitHub 账号状态查询均已明确排除当前任务；未来只读审计属于另行立项的可选能力，不阻塞本任务进入技术方案阶段。

工作量和复杂度评估

• 复杂度：中
• 风险等级：高

依据：自动引用有明确的共享生成点，但手写 artifact Markdown 的边界识别和 Markdown 语义保护需要补充可观察测试；同时本地/远端正文一致性和有效链接保留要求较高。两项外部范围决策已经闭环，不再增加历史远端写入或 GitHub 网络依赖。

分析结论

需求范围已经收敛，可以进入技术方案阶段：优先围绕共享 artifact 引用生成、同步范围内容约束、有效链接保留、明确非用户 token 代码化和现有正文一致性门禁设计实现与测试。方案不得加入历史评论回填或正常路径 GitHub 用户查询。

---

由 codex 自动生成 · 内部追踪：TASK-20260826-184851

[CodeCasterX]

需求分析审查（Round 2）

codex · TASK-20260826-184851

需求分析审查报告

• 审查轮次：第 2 轮
• 产物文件：review-analysis-r2.md
• 审查输入：
  • analysis-r2.md

状态核对

$ git status -s
(empty)
$ ls -la .agents/workspace/active/TASK-20260826-184851/
f	11139	analysis-r2.md
f	14000	analysis.md
f	15701	review-analysis.md
f	9833	task.md
$ tail .agents/workspace/active/TASK-20260826-184851/task.md
- [ ] 代码已审查
- [ ] 文档已更新（如适用）
- [ ] PR 已创建
<!-- 由 complete-task 勾选 -->

## 产物生命周期收据

| event | output | input | input_sha256 | completed_at |
| --- | --- | --- | --- | --- |
| review-analysis.completed | review-analysis.md | analysis.md | 97fcedfccf6055b5e944e74cf861475b4953b21c973552c229125c9528a3a1b8 | 2026-09-01 00:19:49+08:00 |

审查摘要

• 审查者：codex
• 审查时间：2026-09-01 11:17:42+08:00
• 审查范围：3 个任务产物（task.md、analysis-r2.md、review-analysis.md）及 8 个被引用的核心/测试文件区域
• 总体结论：通过
• 结论依据：第二轮分析已准确吸收 HDR-1/HDR-2，账本无待裁决或未决 finding，范围、验收、风险与设计输入均已闭环
• 发现（AI 可处理）：0 阻塞项，0 主要，0 次要 / 人工校验：0

检视覆盖声明

pass_id	scope	evidence	result	gaps_or_assumptions
pass-1	原始任务输入、人工裁决、上一轮审查和代码事实	task.md:23-77,121-142；review-analysis.md:29-123；lib/task/artifact-lifecycle.ts:473-501；lib/platform/issue-comments.ts:60-75,212-254	独立确认两个裁决均已原子落账，并重新核实自动链接生成与本地正文同步事实	任务没有关联 Issue，真实 GitHub 渲染仍以 task.md 已确认事实为来源边界
pass-2	第二轮分析对来源、裁决、验收、影响和风险的追踪	analysis-r2.md:28-123；下方追踪矩阵	HDR-1/HDR-2 均被转化为明确范围与非目标；所有验收项保持可观察	task.md 行号会随生命周期链接追加而漂移，稳定 HDR 锚点仍可可靠定位
pass-3	分析阶段风险镜头及角色、质量、演进场景覆盖	.agents/rules/compatibility-policy.md；analysis-r2.md:45-52,83-112；下方专项表	compatibility-budget 已加载；current-only、单一正文事实源和无账号查询边界符合策略	code-only 风险镜头不适用于分析阶段
pass-4	对“裁决未吸收、范围扩张、验收断链、入口遗漏”候选问题反证	ai task decisions --task 04；analysis-r2.md:35-52,67-123；`rg -n "buildArtifactLinkSection	\]\([^)]*\.md\)	@2x" ...`
pass-5	finding、manual-validation、advisory、账本与 verdict 收敛	task.md:121-142；本报告问题清单与审查分歧账本回写	0 个 AI finding、0 个人工校验、0 个待裁决；形成通过结论	无

lens_id	trigger_evidence	loaded	result
compatibility-budget	修改旧的相对链接写入行为，并裁决历史评论不回填：task.md:42-46,76-77,138-142、analysis-r2.md:51,91,99	yes	current-only；没有双写、同步回退、旧格式兼容读取或长期 shim，历史数据另任务处理
documentation-antipatterns	注册表限定 code 阶段，本轮未修改业务代码或文档实现	not-applicable	不适用
testing-discipline	注册表限定 code 阶段，本轮只审查测试需求	not-applicable	不适用
security-risks	注册表限定 code 阶段；账号身份与权限边界已在 security 视角审查	not-applicable	不适用
migration-risks	注册表限定 code 阶段；分析不引入 schema、迁移或兼容读取	not-applicable	不适用
concurrency-risks	注册表限定 code 阶段；分析不改变异步协调、重试或共享状态	not-applicable	不适用
cross-platform-risks	注册表限定 code 阶段；跨平台路径示例作为需求输入，尚无实现变更	not-applicable	不适用

需求分析专项覆盖

perspective_id	applicability	reviewed_scope	evidence	result_or_gap
user	applicable	错误链接、@2x 展示、本地/远端一致性、有效链接保留和非目标	task.md:23-77；analysis-r2.md:28-52,101-112	covered
maintainer	applicable	共享生成点、同步边界、artifact identity、兼容性和后续维护责任	analysis-r2.md:54-65,75-99；lib/task/artifact-lifecycle.ts:473-501	covered
operations	applicable	marker、分片、幂等、陈旧分片、正文验证、网络/权限和历史副作用	analysis-r2.md:50-52,59-60,77-81,89-99	covered
security	applicable	真实提及与非用户 token 边界、账号查询权限和状态依赖	task.md:132-136；analysis-r2.md:49-50,87,90,105-106	covered
testing	applicable	自动引用、手写 artifact、正反例、正文一致性及完整测试环境	task.md:66-72；analysis-r2.md:62-65,71-73,85-89,95-99,114-119	covered

quality_id	source	stakeholder	priority_or_tradeoff	verification	result_or_gap
Q-PARITY	SRC-CONSTRAINTS	user, operations	必须：本地业务正文与远端评论保持同一表示	从相同本地 task/artifact 渲染评论并用 platform-sync 正文门禁比较	covered
Q-PRECISION	SRC-ACCEPTANCE, HDR-2	user, maintainer	高：只处理明确本地引用和非用户 token，不误伤有效链接或意图不明提及	用危险路径、@2x、真实提及、邮箱及有效链接构造正反例	covered
Q-RELIABILITY	SRC-FACTS	operations, maintainer	必须保持 marker、分片、幂等和正文一致性状态机	运行评论单元/集成/platform-sync e2e 与完整 npm test	covered
Q-NETWORK-INDEPENDENCE	HDR-2	user, operations	必须：正常生成和同步不依赖 GitHub 用户 API	在无网络/无账号查询 stub 下验证生成与同步仍确定完成	covered

evolution_id	source	confirmation_status	classification	boundary_evidence	result_or_gap
EV-HISTORICAL-COMMENTS	HDR-1	confirmed	design-input	task.md:138-142、analysis-r2.md:51,91,103：current-only，未来回填须另行立项	covered
EV-ACCOUNT-AUDIT	HDR-2	confirmed	design-input	task.md:132-136、analysis-r2.md:50,90,106：未来审计仅可独立、只读、非阻塞，且不属于本任务	covered

acceptance_id	observable_input	action	expected_result	status_or_gap
AC-AUTO-REF	完成任一 canonical 生命周期产物或 PR review	检查本地 task.md，并渲染/sync task 评论	artifact 文件名以代码文本呈现且不可点击；本地与远端正文一致	verifiable
AC-ARTIFACT-PATH	artifact 正文包含 workspace、用户目录或临时任务文件引用	执行同步范围内容约束并渲染/sync artifact 评论	不产生指向 Issue 相对地址或本地/临时路径的错误链接	verifiable
AC-MENTION	正文包含明确非用户语义 @2x	生成并渲染/sync 评论	token 使用代码格式，不成为用户主页链接	verifiable
AC-PRESERVE	正文包含有效仓库/Issue/PR/commit/外链、真实提及、邮箱或正式文档链接	运行相同生成/校验路径	内容保持原语义，不被泛化替换或账号状态查询改写	verifiable
AC-CURRENT-ONLY	仓库或远端存在旧评论和旧链接格式	执行当前实现与同步测试	不扫描、不批量编辑历史评论，也不维护新旧双写路径	verifiable
AC-NO-USER-LOOKUP	正常生成或同步内容包含账号形态提及	运行生成/同步并监测平台客户端调用	不调用 GitHub 用户 API；意图不明提及保留原文	verifiable
AC-REGRESSION	完成上述行为实现	运行相关结构性测试与 npm test	新用例和完整项目测试通过，且不使用文案关键词语义断言	verifiable

追踪矩阵

source_id	upstream	reviewed_target	verification	status_or_gap
SRC-USER	task.md:33-38,54-58 用户请求与确认	analysis-r2.md:28-52 的目标、范围与同源正文规则	逐项对照 artifact 引用、@2x 和本地/远端一致性	covered
SRC-FACTS	task.md:40-46 已核实行为	analysis-r2.md:54-65,67-81 的文件和影响	nl 核实共享 helper、评论正文读取与 verification-sync 比较	covered
SRC-CONSTRAINTS	task.md:48-52 同步范围和不误改正式文档	analysis-r2.md:45-52,75-89,101-108 的边界、风险和假设	正反例验收 AC-ARTIFACT-PATH/AC-PRESERVE	covered
SRC-ACCEPTANCE	task.md:66-72 五项验收	AC-AUTO-REF 至 AC-REGRESSION；analysis-r2.md:62-65,71-73,95-99	已定位单元、集成与 e2e 测试入口	covered
HDR-1	task.md:138-142 人工裁定只修复未来内容	analysis-r2.md:39,51,81,91,99,103,112,123	ai task decisions --task 04 无待裁决；AC-CURRENT-ONLY 可验证	covered
HDR-2	task.md:132-136 人工裁定正常路径不查账号	analysis-r2.md:40,49-50,81,87,90,99,104-106,112,123	ai task decisions --task 04 无待裁决；AC-NO-USER-LOOKUP 可验证	covered
REVIEW-R1	review-analysis.md:29-123,215-225 上一轮无 AI finding，仅等待裁决	analysis-r2.md:35-41 的响应	对照账本终态与 HDR 原文；无 finding 需要 finding-review	covered

问题清单

阻塞项（必须修复）

（无）

主要问题（建议修复）

（无）

次要问题（低影响但需闭环）

（无）

非阻塞建议

• 后续生命周期产物引用 task.md 中的人工裁决时，优先使用稳定的 task.md#HDR-N 锚点；行号会因自动追加产物链接和活动日志而漂移。analysis-r2.md:39-40 已同时使用 HDR 标识，当前可追踪性不受影响。

人工校验项

（无）

审查分歧账本回写

• 上一轮没有 AN finding；本轮无对象需要调用 finding-review。
• HD-1、HD-2 已由 ai decide 原子置为 human-decided，证据分别为 task.md#HDR-1、task.md#HDR-2；本轮不重写人工裁决状态。
• 本轮没有新增 AI finding，不调用 finding-upsert。

证据原文

• 断言：统一决策查询确认当前没有待人工裁决项。

$ ai task decisions --task 04
No pending decisions.

• 断言：两项账本行均为终态，且 HDR 原文与第二轮分析采用的范围一致。

$ nl -ba .agents/workspace/active/TASK-20260826-184851/task.md | sed -n '121,142p'
   121	## 审查分歧账本
   122	
   123	<!-- 每条 review finding 一行；状态机/证据规则见 .agents/rules/review-handshake.md。阶段推进与 complete-task gate 读取本段。无分歧时保留表头即可。 -->
   124	
   125	| id | stage | round | severity | status | evidence |
   126	|----|-------|-------|----------|--------|----------|
   127	| HD-1 | analysis | - | decision | human-decided | task.md#HDR-1 |
   128	| HD-2 | analysis | - | decision | human-decided | task.md#HDR-2 |
   129	
   130	## 人工裁决
   131	
   132	### HDR-2
   133	
   134	- **原账本 ID**：HD-2
   135	- **裁决时间**：2026-09-01 11:03:21+08:00
   136	- **裁决结果**：选择方案 A：正常生成和同步流程不查询 GitHub，只对明确的非用户语义 token（如 @2x）使用代码格式，并保留账号形态但意图不明的提及。若未来需要账号状态判断，另设独立的只读审计/诊断动作，仅报告结果，不改写内容，也不阻塞正常同步。理由：账号是否存在不能证明作者是否有意提及，且查询会引入网络、权限和限流依赖。
   137	
   138	### HDR-1
   139	
   140	- **原账本 ID**：HD-1
   141	- **裁决时间**：2026-09-01 09:18:59+08:00
   142	- **裁决结果**：选择方案 A：仅修复未来生成/同步的内容，不批量回填历史 Issue 评论。理由：当前任务只明确未来规则，未提供可安全批量回填所需的 Issue 范围、必要性、期限和退出条件。

• 断言：第二轮分析把两个裁决落实为当前范围、非目标、风险、假设和结论。

$ nl -ba .agents/workspace/active/TASK-20260826-184851/analysis-r2.md | sed -n '47,52p;85,91p;99,112p;121,123p'
    47	1. 生命周期自动追加到 `task.md` 的 artifact 引用不再生成 Markdown 相对链接，而使用不可点击的代码文本；普通生命周期完成事件和 PR review 完成路径都必须覆盖。
    48	2. 同步范围内的 artifact 正文不能以链接形式暴露 workspace 路径、用户目录、临时任务文件或其他明显只在本地有效的文件引用。正式项目文档及已经确认有效的仓库、Issue、PR、commit 和外部链接不属于泛化替换范围。
    49	3. 对明确的非用户语义 token（当前已确认示例为 `@2x`）使用代码格式，避免 GitHub 自动渲染为用户链接；看起来像账号但意图不明的提及保留原文，不根据账号当前是否存在来改写。
    50	4. 正常生成和同步流程不访问 GitHub 用户 API，不把网络、权限或限流状态引入正文生成主路径。未来若需要账号状态判断，应另建独立的只读审计/诊断动作，只报告结果，不修改内容，也不阻塞同步；该动作不属于本任务实现范围。
    51	5. 不扫描或编辑历史 Issue 评论。只约束本轮之后生成或重新同步的内容；历史回填如有需要，应另建带明确对象范围、必要性、时间窗口和退出条件的任务。
    52	6. 不在同步阶段单独改写远端 payload。`platform-comment` 和 `verification-sync` 的 marker、分片、幂等更新、陈旧分片删除及正文相等性契约继续有效。
    85	- **本地链接识别过窄**：只改自动 helper 可能遗漏手写 artifact 正文中的 workspace、用户目录或临时任务引用。方案阶段需要明确同步范围内的允许/拒绝模式，并用正反例验证。
    86	- **本地链接识别过宽**：粗略替换所有 Markdown 链接会破坏有效仓库文档、Issue/PR/commit 或外部链接；不能把正式文档中的相对链接当作任务评论问题处理。
    87	- **`@` 处理误伤**：泛化地转义所有 `@` 会改变真实用户提及、邮箱或业务文本。应只覆盖已经明确具有非用户语义的 token 模式，账号形态但意图不明的提及按 HDR-2 保留。
    88	- **Markdown 结构误判**：链接或 `@2x` 可能位于行内代码、代码围栏、表格、HTML 或 receipt/reference 内容中。方案阶段需要保护已有代码语义和结构化解析，不以自然语言关键词作测试门禁。
    89	- **同步层改写造成漂移**：只修改 GitHub payload 会使本地正文和远端正文不相等；生成、存储、发布和校验必须共享最终表示。
    90	- **外部状态依赖**：GitHub 用户查询会引入认证、权限、网络、限流、账号可见性和状态变化问题。HD-2 已裁决正常路径不查询；未来审计只能独立、只读、非阻塞。
    91	- **历史副作用**：批量编辑既有 Issue 评论会扩大范围并改变共享记录。HD-1 已裁决 current-only，本任务不得加入扫描或回填流程。
    99	- 不依赖 GitHub 用户 API，也不引入历史评论回填、旧格式双写、同步回退或长期兼容 shim；这与两项人工裁决及 compatibility policy 一致。
   100	
   101	## 假设
   102	
   103	- 本轮分析和后续实现只覆盖未来生成/同步内容；历史评论保留现状。
   104	- 明确的非用户 token 以 `@2x` 为当前验收代表；不能从一个示例推导为“所有 @ 文本都应代码化”。
   105	- 账号形态但意图不明的提及保留原文，不因无法确认账号状态而失败；正常同步不执行 GitHub 查询。
   106	- 未来只读账号审计若要建立，必须作为独立诊断能力设计，不作为本任务的隐藏实现或完成门禁。
   107	- 正式项目文档和归档 manifest 的有效相对链接不属于 Issue 评论治理范围。
   108	- 当前任务无有效 `issue_number`，因此本轮不会执行远端 Issue 或评论同步；已有 `WW-1` 仍记录 Issue 创建失败告警。
   109	
   110	## 未决问题
   111	
   112	本轮没有剩余的范围裁决项。历史回填和 GitHub 账号状态查询均已明确排除当前任务；未来只读审计属于另行立项的可选能力，不阻塞本任务进入技术方案阶段。
   121	## 分析结论
   122	
   123	需求范围已经收敛，可以进入技术方案阶段：优先围绕共享 artifact 引用生成、同步范围内容约束、有效链接保留、明确非用户 token 代码化和现有正文一致性门禁设计实现与测试。方案不得加入历史评论回填或正常路径 GitHub 用户查询。

• 断言：自动 artifact 引用仍由单一 helper 生成，并写成相对 Markdown 链接；分析定位的首要入口准确。

$ nl -ba lib/task/artifact-lifecycle.ts | sed -n '473p;482,487p;498,501p'
   473	function buildArtifactLinkSection(content: string, artifact: ArtifactIdentity): {
   482	  const label = english
   483	    ? `${spec.labels[1]} (Round ${artifact.round})`
   484	    : `${spec.labels[0]}（Round ${artifact.round}）`;
   485	  const link = `[${label}](${artifact.name})`;
   486	  let body = extractSection(content, aliases);
   487	  if (body.includes(`](${artifact.name})`)) return { aliases, heading, body };
   498	  if (placeholder >= 0) lines[placeholder] = link;
   499	  else lines.push(...(body ? ['', link] : [link]));
   500	  body = lines.join('\n').replace(/^\n+|\n+$/g, '');
   501	  return { aliases, heading, body };

自我质疑

• 未在真实 GitHub Issue 上复测 @2x 自动链接；任务无 issue_number，本轮把 task.md:45 的已确认事实作为来源。若该事实被推翻，AC-MENTION 的必要性会改变，但不影响两个已裁决范围的闭环。
• 第二轮分析中的 task.md:121-138 / task.md:121-132 行号会随生命周期写入漂移，当前已分别核对稳定锚点 task.md#HDR-1 / task.md#HDR-2 和完整裁决原文；因此没有把行号漂移升级为 finding。

亮点

• 第二轮分析没有把人工裁决简单复述为结论，而是同步落实到需求范围、非目标、风险、依赖、假设和验收边界。
• HDR-2 清楚隔离了“明确非用户 token 代码化”和“账号状态审计”，避免把网络与身份状态引入正常生成路径。
• current-only 与本地/远端单一正文事实源保持一致，未引入兼容分支或历史数据迁移。

与方案一致性

• 当前尚未进入方案/实现阶段，分析只给出设计输入与约束，未提前锁定架构或技术实现
• 没有把历史回填或账号状态审计扩张为当前任务范围

结论与建议

审查决定

• 通过
• 需要修改
• 拒绝

下一步

进入技术方案阶段，围绕共享 artifact 引用生成、同步范围内容约束、正反例保护和正文一致性门禁形成最小实现计划；方案不得加入历史评论回填或正常路径 GitHub 用户查询。

---

由 codex 自动生成 · 内部追踪：TASK-20260826-184851

[CodeCasterX]

技术方案（Round 1）

codex · TASK-20260826-184851

技术方案

• 方案轮次：Round 1
• 产物文件：plan.md
• 输入分析：analysis-r2.md
• 输入审查：review-analysis-r2.md（Approved）

状态核对

$ git status -s
(empty)
$ ls -la .agents/workspace/active/TASK-20260826-184851/
f	11139	analysis-r2.md
f	14000	analysis.md
f	20070	review-analysis-r2.md
f	15701	review-analysis.md
f	10479	task.md
$ tail .agents/workspace/active/TASK-20260826-184851/task.md
- [ ] PR 已创建
<!-- 由 complete-task 勾选 -->

## 产物生命周期收据

| event | output | input | input_sha256 | completed_at |
| --- | --- | --- | --- | --- |
| review-analysis.completed | review-analysis.md | analysis.md | 97fcedfccf6055b5e944e74cf861475b4953b21c973552c229125c9528a3a1b8 | 2026-09-01 00:19:49+08:00 |
| review-analysis.completed | review-analysis-r2.md | analysis-r2.md | 768c50cc4abf90b67c74139beaaa8192d648da00658dc88fbe42a77523df5f0e | 2026-09-01 11:22:36+08:00 |

方案目标与边界

问题理解

当前 lifecycle helper 将 artifact 文件名写成 Markdown 相对链接；task/artifact 评论又直接发布本地正文，因此 GitHub 会把本地文件引用解析为 Issue 下的错误链接。另一个确定问题是非用户语义的 @2x 可能被 GitHub 自动渲染为用户提及。解决方案必须同时覆盖本地源文件和远端评论的正文契约，并保持有效链接和真实提及的原语义。

目标

• 生命周期自动写入 task.md 的 artifact 引用使用“描述：文件名”的代码文本，不再生成指向 Issue 相对地址的 Markdown 链接。
• 对 Issue 评论同步边界内的明确危险本地链接和未代码化的非用户 token 提供确定性约束，避免错误链接进入 GitHub。
• 本地文件是唯一正文事实源；同步层只封装、分片、发布和校验，不对远端 payload 做隐藏改写。
• 正常生成和同步不查询 GitHub 用户 API；账号形态但意图不明的提及原样保留。
• 只处理未来生成或重新同步的内容，不新增历史 Issue 评论扫描或批量回填流程。

非目标

• 不处理账号改名、删除或不可访问状态，不实现 GitHub 账号存在性判断。
• 不修改 README、归档 manifest 或其他正式项目文档中的有效链接。
• 不删除或重定义已有 platform-comment backfill 命令；本任务不调用它来批量修复历史评论，既有补发能力保持原有边界。
• 不新增旧格式双写、同步回退、adapter、shim 或并行正文事实源。

约束条件

• 本地 task/artifact Markdown 是唯一正文事实源，远端同步不得单独改写内容。
• 只处理未来生成或重新同步的当前内容，不批量编辑历史 Issue 评论。
• 正常生成和同步不查询 GitHub 用户状态；不确定的账号形态提及必须保留。
• 有效外链、Issue/PR/commit、anchor 和正式文档链接不得被泛化替换。
• 必须保持 marker、分片、幂等、陈旧分片删除和 platform-sync 正文相等性契约。

技术方法

采用“生成时使用规范表示 + 源文件写入前的静态约束 + 同步前 fail-closed 校验”的组合：

1. 自动 artifact 引用在共享生成 helper 中直接生成代码文本。
2. 对可由代码控制的 task 创建内容，仅将明确的非用户 token（当前为 @2x）在非代码语境下包成行内代码；已有行内代码、代码围栏、真实账号形态提及和普通业务文本不改写。
3. 对 agent 直接写入的 artifact Markdown，不在同步阶段自动改写。artifact 完成事件和直接评论同步在本地发现危险链接或未代码化 @2x 时 fail closed，并返回行号、列号和修复建议，要求先修复本地文件。
4. 平台同步和 platform-sync 验证均继续使用修复后的本地原文；验证仍比较同一份正文，不引入“本地一份、远端另一份”的转换层。

共享内容策略

新增无平台依赖的 lib/task/issue-comment-content.ts，作为 task、artifact 和平台代码共同使用的纯函数策略模块：

• formatKnownNonUserTokens(content)：只在 fenced code 和 inline code 之外，把明确的 @2x token 包为 `@2x`；重复执行幂等，不处理 @alice、邮箱或其他未知 @ 文本，不访问网络。
• findIssueCommentViolations(content)：以轻量 Markdown 词法扫描返回结构化违规项（类型、行、列、token、修复说明），跳过代码围栏和行内代码。检查范围限定为：
  • canonical lifecycle artifact 文件名及其 workspace 引用被 Markdown 链接化；
  • /workspace/、用户目录、临时目录、Windows drive/UNC 等明显本地路径作为链接目标；
  • 包含任务 workspace / task identity 的临时任务文件引用；
  • 非代码语境中的明确非用户 token @2x。
• 对 https://、mailto:、Issue/PR/commit URL、#anchor、普通业务文本、真实账号形态提及以及正式文档的有效相对链接不报违规；未知语义不做宽泛替换。
• formatKnownNonUserTokens 仅用于代码拥有的 task 文本生成；artifact 和同步路径使用 findIssueCommentViolations 拒绝不安全源文件。这样不会把“同步修复”误做成远端专属变换。

自动 artifact 引用

修改 lib/task/artifact-lifecycle.ts:473-501：保留现有 artifact family、round、placeholder 和幂等判断，仅把最终引用从 [label](artifact.md) 改为 ${label}：\artifact.md`。lib/task/events.ts和lib/task/activity-intent.ts` 继续调用同一个 helper，因此普通生命周期完成和 PR review 完成路径自动共享新规则。

task 内容生成与 artifact 完成门禁

• 修改 lib/task/create.ts:172-241：对描述和 task input 的正文渲染调用 formatKnownNonUserTokens，确保新建 task 的 @2x 在本地源文件中就使用代码文本。候选输入摘要仍基于原始结构化输入，输出保持确定性，不能把格式化结果当作新的外部数据源。
• 修改 lib/task/artifact-lifecycle.ts:453-470：validateCompletedArtifact 读取已落地的 artifact 内容并调用 findIssueCommentViolations。有违规时返回新的 ARTIFACT_CONTENT_INVALID，不继续写入 task.md 的产物链接、receipt 或 Activity Log；错误消息带出首个违规位置和可操作修复示例。
• 不在 writeTask 中对任意 task 内容做宽泛重写。生命周期自动引用由共享 helper 负责；其他手写内容由同步前校验保护，避免在所有 task mutation 中引入隐式正文变化。

评论同步与验证

• 修改 lib/platform/issue-comments.ts:230-255,308-340：在任何平台读取或写入之前，对 kind=task 的 task 正文和 kind=artifact 的 artifact 正文执行同一静态校验。违规返回现有 COMMENT_PAYLOAD_INVALID 错误形态，禁止 create、patch、delete 和 stale-chunk 清理；summary/cancel 的既有正文契约不扩展本任务规则。
• 保留 marker、frontmatter details、artifact 分片、UTF-8 边界、幂等更新、重试和 owner 检查。校验不调用 GitHub 用户接口；正常流程最多执行现有平台上下文和 Issue comments 操作。
• 修改 lib/platform/verification-sync.ts:604-664：在本地/远端正文相等比较前复用同一违规检查；不对远端正文做替换。这样 platform-sync 不能因为远端偶然与本地一起保留危险文本而错误放行。
• HD-1 的 current-only 规则保持不变：不改变历史评论，不在本任务新增 backfill。已有 Issue fix: 修复 Issue 评论中的本地路径和误识别链接 #941 的后续 task/plan/artifact 同步只发布当前本地源文件。

方案对比

备选 A：只在 GitHub payload 中替换

否决。它会使本地 task/artifact 与远端评论产生正文差异，破坏 verification-sync 的相等性门禁，也隐藏了源文件实际表示。

备选 B：每次同步查询 GitHub 用户状态

否决。HD-2 已明确正常路径不查询账号状态；账号是否存在不能证明作者是否有意提及，且会增加认证、权限、网络、限流和可见性依赖。真实提及原样保留，未来审计另行设计为只读、只报告、非阻塞动作。

备选 C：引入完整 Markdown AST 并重写所有链接

否决。当前项目没有 Markdown 解析依赖，全面重写会误伤有效文档链接、HTML、receipt/reference、表格和代码语义，改动和测试面显著扩大。选定方案只对明确危险模式做轻量词法保护，不能唯一判断的内容保留并 fail closed。

备选 D：只修改自动 artifact helper，不做内容校验

不足。它能修复自动追加的相对链接，但无法阻止 agent-authored artifact 中的 workspace 链接或 raw @2x 进入 Issue。选定方案增加本地完成门禁和同步前门禁，保证未知手写内容不会静默发布。

实施步骤

按以下顺序实施，每步都保持可独立验证：

1. 先写内容策略单元测试

   • 覆盖 @2x 的代码化、重复执行幂等、inline/fenced code 保护、真实 @alice/邮箱保留。
   • 覆盖 canonical artifact 链接、workspace/用户目录/临时路径违规，以及外部 URL、Issue/PR/commit、anchor 和有效文档链接保留。
   • verify：策略测试能区分“需代码化”“需拒绝”“保持原样”三类结果，且不使用 GitHub 网络。

2. 实现共享策略和自动引用格式

   • 新增 lib/task/issue-comment-content.ts。
   • 修改 lib/task/artifact-lifecycle.ts 的引用生成；同步扩展 artifact 错误类型和完成校验。
   • 修改 lib/task/create.ts 的描述/task input 渲染。
   • verify：生命周期 helper 输出不可点击代码文本；artifact 违规在 task event 完成前失败且不改 task.md。

3. 接入评论同步和平台验证

   • 修改 lib/platform/issue-comments.ts，把校验放在首次远端读取/写入之前。
   • 修改 lib/platform/verification-sync.ts，仅校验本地源文件后继续现有正文比较。
   • verify：违规内容不会产生平台写操作；安全内容仍保持现有 marker、分片、幂等和正文相等行为；不存在用户 API 请求。

4. 更新生命周期、同步和平台回归测试

   • 更新旧的 .md 相对链接断言为代码文本断言。
   • 增加 task-create、task-event、platform-comment CLI 和 platform-sync e2e 的正反例。
   • 保留既有 backfill 测试，确认本任务没有改变 backfill 命令的既有接口和 marker 行为。
   • verify：目标测试通过，且未修改正式文档链接或历史评论 fixture 的预期语义。

5. 执行完整验证并生成实现输入

   • 先运行相关测试，再运行 npm run build 和 npm test。
   • 检查 git diff：仅包含本任务列出的源码和测试文件；确认没有新增 GitHub 用户查询、历史回填或兼容 shim。
   • 完成实现后由 code-task 产出实现报告并创建本地 checkpoint；本方案阶段不执行编码。

文件清单

新建

• lib/task/issue-comment-content.ts - 共享的 Issue 评论 Markdown 词法策略、已知 token 格式化和违规诊断。
• tests/unit/task/issue-comment-content.test.ts - 内容策略的纯单元测试。

修改

• lib/task/artifact-lifecycle.ts - 自动 artifact 引用改为代码文本；完成 artifact 时增加内容约束和错误分类。
• lib/task/create.ts - 新建 task 正文对明确非用户 token 使用代码格式。
• lib/platform/issue-comments.ts - task/artifact 同步前静态校验；保留平台状态机和分片契约。
• lib/platform/verification-sync.ts - platform-sync 比较前校验本地 task/artifact 内容。
• tests/unit/cli/task-artifact-lifecycle.test.ts - helper 输出和 artifact 内容门禁测试。
• tests/unit/platform/issue-comments.test.ts - 同步拒绝危险内容、保留安全内容和无用户查询行为测试。
• tests/integration/cli/task-create.test.ts - 新建 task 的 @2x 代码化回归测试。
• tests/integration/cli/task-event.test.ts - 生命周期产物引用新表示和 unsafe artifact fail-closed 测试。
• tests/integration/cli/platform-comment.test.ts - CLI 同步前校验与既有同步状态机回归测试。
• tests/e2e/core/validate-artifact-platform-sync.test.ts - 本地/远端正文一致性及内容约束 e2e 测试。

明确不修改

• lib/task/commands/issue-body.ts：初始 Issue body 的边界保持不变。
• lib/task/write.ts：不对所有 task mutation 做隐式 Markdown 重写。
• lib/platform/completion-backfill.ts：不扩展历史评论回填范围。
• .agents/skills/* 和正式项目文档：本任务通过运行时生成/校验契约完成治理，不改写技能文案或 README 语义。

数据流与错误处理

task create input
        │
        ├─ formatKnownNonUserTokens ──> local task.md
        │                                  │
        │                                  └─ buildArtifactLinkSection -> `artifact.md`
        │
+ agent-authored artifact.md
        │
        ├─ validateCompletedArtifact ──X unsafe -> actionable local error
        │
        └─ platform-comment sync
             ├─ local policy check ──X unsafe -> no remote operation
             └─ raw local content -> marker/chunk sync -> GitHub comment
                                      │
                                      └─ verification-sync compares same raw content

• 内容策略错误属于不可安全解释的本地输入错误，使用 fail closed，不降级为 warning，不尝试通过账号查询或远端改写“猜测修复”。
• 远端列表、创建、更新、删除和重试的既有错误分类保持不变；本地内容错误在远端 I/O 前返回，避免产生部分外部副作用。
• 当前任务 Issue fix: 修复 Issue 评论中的本地路径和误识别链接 #941 已绑定；方案完成后按工作流同步更新 Issue 元数据、task 评论和 plan.md artifact 评论。该同步只发布当前产物，不是历史评论回填。

验证策略

行为矩阵

输入	预期行为	验证位置
自动完成 analysis.md / plan.md / code.md 等产物	task.md 写入描述加 `artifact.md`，不可点击	task-artifact-lifecycle.test.ts、task-event.test.ts
artifact 含 [x](analysis.md) 或 workspace/用户目录本地目标	完成事件或直接同步 fail closed，无 task/远端写入	artifact lifecycle、platform-comment tests
正文含 raw @2x	task-create 对受控输入代码化；手写 artifact/同步输入拒绝并给修复位置	content policy、task-create、task-event、platform-comment
正文含 `@2x`、@alice、邮箱	保持原样，不查询 GitHub 用户状态	content policy、platform-comment
有效外链、Issue/PR/commit、anchor、正式文档相对链接	保持原语义	content policy、platform-sync e2e
历史已有评论	不扫描、不批量编辑	backfill 边界回归和 diff 检查
同一安全同步重复执行	第二次仍为 no-op	既有 issue-comments/platform-comment 测试

命令级验证

• 目标单元与集成测试：node --test 对应测试文件。
• 完整项目验证：npm run build、npm test。
• 平台同步验证：使用现有 fake GitHub client，断言本地/远端正文相等、危险内容失败，并确认调用记录中不存在用户状态查询 endpoint。
• 人工检查：查看生成的 task 评论和 artifact 评论，确认 artifact 文件名及 @2x 不是可点击用户/相对链接；不执行历史评论批量编辑。

影响与风险

• 行为变化：未来生命周期自动引用从可点击相对链接改为代码文本；这是任务已确认的当前契约变化。
• 错误处理变化：含明确危险内容的 artifact 将在完成或同步时被拒绝，维护者需修复本地源文件；错误不会被隐藏成远端成功。
• 风险控制：策略仅识别明确模式，跳过代码语境和有效链接；不依赖第三方 Markdown parser，不引入 GitHub 查询。
• 兼容性：没有历史数据、旧调用方或不可切换的公共协议证据需要兼容；按 current-only 实施，不双写旧链接格式。
• 性能：新增的是对本地评论正文的一次线性扫描，远小于现有平台 I/O；不增加网络请求。
• 可回退性：代码变更集中在共享 helper、内容策略和同步门禁；回退可恢复旧输出，但会重新暴露已修复的 Issue 相对链接问题。

未决问题

无。本方案遵循已批准的 HD-1、HD-2；历史回填和账号状态审计均明确不属于当前实现。

方案结论

该方案满足本地/远端同源正文、current-only、无 GitHub 用户查询和有效链接保留约束，改动集中且可测试。方案完成后必须先经过 review-plan 人工审查，批准前不得进入 code-task。

---

由 codex 自动生成 · 内部追踪：TASK-20260826-184851

[CodeCasterX]

技术方案审查（Round 1）

codex · TASK-20260826-184851

技术方案审查报告

• 审查轮次：第 1 轮
• 产物文件：review-plan.md
• 审查输入：
  • plan.md

状态核对

$ git status -s
(empty)
$ ls -la .agents/workspace/active/TASK-20260826-184851/
f	11139	analysis-r2.md
f	14000	analysis.md
f	17088	plan.md
f	20070	review-analysis-r2.md
f	15701	review-analysis.md
f	10657	task.md
$ tail .agents/workspace/active/TASK-20260826-184851/task.md
- [ ] PR 已创建
<!-- 由 complete-task 勾选 -->

## 产物生命周期收据

| event | output | input | input_sha256 | completed_at |
| --- | --- | --- | --- | --- |
| review-analysis.completed | review-analysis.md | analysis.md | 97fcedfccf6055b5e944e74cf861475b4953b21c973552c229125c9528a3a1b8 | 2026-09-01 00:19:49+08:00 |
| review-analysis.completed | review-analysis-r2.md | analysis-r2.md | 768c50cc4abf90b67c74139beaaa8192d648da00658dc88fbe42a77523df5f0e | 2026-09-01 11:22:36+08:00 |

审查摘要

• 审查者：codex
• 审查时间：2026-09-01 12:54:54+08:00
• 审查范围：plan.md、已批准的 analysis-r2.md / review-analysis-r2.md、task.md、Issue fix: 修复 Issue 评论中的本地路径和误识别链接 #941，以及 5 个相关源码入口和对应测试入口
• 总体结论：需要修改
• 发现（AI 可处理）：0 阻塞项，2 主要，0 次要 / 人工校验：0

检视覆盖声明

pass_id	scope	evidence	result	gaps_or_assumptions
pass-1	任务来源、人工裁决、已批准分析、Issue #941、方案及现有源码入口	task.md:24-78,124-145；analysis-r2.md:43-123；review-analysis-r2.md；plan.md；platform-issue inspect；lib/task/create.ts:225-232；lib/task/artifact-lifecycle.ts:453-501；lib/platform/issue-comments.ts:230-340	独立识别出 task 标题生成遗漏和 Markdown 结构保护未落成两个候选问题	本阶段不执行实现或测试；只评估方案能否指导实现
pass-2	已批准需求到设计决策、实施步骤和验证矩阵的追踪	analysis-r2.md:45-52,83-99 对照 plan.md:60-97,117-140,199-227	artifact 引用、同源正文、current-only、无用户 API、同步前门禁均有设计映射；@2x 生成入口和结构保护存在断链	Issue body 的旧“未决事项”是创建时快照；真实裁决以 task ledger/HDR 为准
pass-3	风险镜头与架构专项	plan.md:55-58,62-97,195-227；.agents/rules/compatibility-policy.md	命中 compatibility-budget；current-only、单一事实源和 fail-closed 合规。跨 task/platform/verification 的控制流及错误语义变化触发 Mini-ATAM	代码阶段专用的测试、安全、迁移、并发、跨平台镜头在 plan 阶段不适用
pass-4	对候选 finding 和放行结论进行反证	lib/platform/issue-comments.ts:60-74 证明整个 task body 会被发布；lib/task/create.ts:225-232 证明标题与描述/输入走不同插入点；analysis-r2.md:88 对照 plan.md:73-79,121-124	同步前校验能阻止危险标题发布，但不能满足“受控生成即代码化”，故 PL-1 仅降为 major；未找到覆盖 HTML/receipt/reference 状态与测试的文字，PL-2 保留 major	未用真实 GitHub 渲染复测；两项 finding 均不依赖平台渲染细节
pass-5	finding 分类、人工项、账本与 verdict 收敛	本报告 #PL-1、#PL-2；task-ledger stage-status --stage plan 的审查前基线	2 个可由方案修订闭环的 major；无 blocker、minor、manual-validation 或新人工裁决	最终计数以 ledger 写入后的 task-review finalize-summary 原子快照为准

lens_id	trigger_evidence	loaded	result
compatibility-budget	plan.md:55,97,210,225 明确只处理未来生成/重新同步内容，拒绝历史回填、旧格式双写和 shim	yes	current-only 有上游 HDR-1 来源；单一正文事实源、同步前 fail-closed 和可操作修复符合策略，不要求兼容层
documentation-antipatterns	本轮是 plan 阶段，尚无 Markdown/规则/帮助文本实现 diff	not-applicable	code 阶段镜头，不适用于本轮
testing-discipline	本轮是 plan 阶段，尚无测试 diff	not-applicable	code 阶段镜头；本轮仅从方案完整性检查测试策略
security-risks	本轮是 plan 阶段，且方案不改变认证授权、凭据或信任身份查询	not-applicable	code 阶段镜头，不适用于本轮
migration-risks	不新增持久化 schema、兼容读取或历史迁移；旧正文按 current-only 在重新同步时 fail closed	not-applicable	code 阶段镜头；兼容边界已由 compatibility-budget 覆盖
concurrency-risks	方案保留既有 marker、幂等、重试和陈旧分片状态机，不设计新的共享异步状态	not-applicable	code 阶段镜头，不适用于本轮
cross-platform-risks	方案列出 POSIX、Windows drive/UNC 本地路径，但本轮没有代码 diff	not-applicable	code 阶段需重新触发；方案验证矩阵应覆盖这些路径形态

技术方案架构覆盖

assessment_id	classification	trigger_evidence	review_depth	result_or_gap
architecture-significance	architecture-significant	plan.md:62-97 新增 task 内容策略边界，并改变 task lifecycle → platform-comment → verification-sync 的跨组件控制流和公开错误行为	mini-atam	总体边界合理；task 生成字段覆盖与 Markdown 词法契约有 gap

quality_scenario_id	source_id	business_driver	quality_attribute	priority	stimulus	context	expected_response	measure	result_or_gap
QS-CORRECTNESS	AC-ARTIFACT, AC-PATH	避免 Issue 评论生成错误本地链接	correctness	high	lifecycle 完成或 agent artifact 含本地引用	本地完成及同步前	自动引用为代码文本，危险手写链接在远端 I/O 前失败	task.md 无新 canonical artifact 链接；平台调用记录为 0	covered
QS-PRECISION	AC-MENTION, R-MARKDOWN	避免误提及且不破坏有效 Markdown	precision	high	task/artifact 含 @2x、代码、HTML、reference 或有效链接	生成、完成和同步	明确 token 代码化或可操作拒绝，安全结构保持原样	正反例逐项通过且本地/远端正文相等	gap：标题字段及 HTML/reference 结构未完整落到设计/测试
QS-OPERABILITY	HDR-1, AC-SYNC	保持同步可诊断且无隐藏改写	operability	high	重新同步含旧危险正文的 task/artifact	current-only 升级后	fail closed，报告首个位置和修复方式，不产生远端副作用	typed error 含 line/column，远端调用记录为 0	covered

decision_id	selected_option	alternative_option	benefit	cost	assumption	rejection_reason	result_or_gap
D-CONTENT	生成规范表示 + 本地/同步门禁	仅远端 payload 改写	单一事实源，可由 platform-sync 验证	旧正文重新同步前需显式修复	current-only 已由 HDR-1 批准	远端改写破坏正文相等性	covered
D-LEXER	无依赖轻量 Markdown 扫描	完整 Markdown AST 重写	改动集中、无新依赖、可 fail closed	必须自行定义足够精确的词法状态	明确危险模式有限	AST 重写面过大且易误伤	gap：所需状态和保护矩阵不完整
D-IDENTITY	明确 @2x 模式，不查询 GitHub 用户	正常路径查询用户状态	确定、无网络/权限/限流依赖	不判断真实账号可访问性	HDR-2 已批准	存在性不能证明作者意图	covered

risk_id	decision_id	risk_or_sensitivity	affected_quality_attributes	tradeoff	mitigation_or_validation	result_or_gap
R-FIELD-COVERAGE	D-CONTENT	受控 task 字段未全部经过规范表示	correctness, operability	缩小变更面会留下失败入口	对所有进入 task comment 的受控正文插入点建字段矩阵	gap：见 PL-1
R-MARKDOWN	D-LEXER	代码/HTML/reference/转义边界误判	precision, correctness	轻量实现换取更高的自定义边界责任	明确状态机、位置规则和结构正反例	gap：见 PL-2
R-REMOTE	D-CONTENT	校验晚于平台读取导致无谓或部分外部操作	operability	前置校验需调整调用顺序	在 platform context/comment list 前构造并校验 desired content，断言调用为 0	covered

decision_id	door_type	reversal_cost	migration_or_rollback	decision_status	result_or_gap
D-CONTENT	two-way	中；回退会恢复错误链接风险	回退共享 helper 与门禁；本地正文不需数据逆迁移	resolved	covered
D-LEXER	two-way	低至中；策略模块集中	移除或收窄规则并重新同步修复后的本地源文件	resolved	gap：实现契约需补全，不需要人工裁决
D-IDENTITY	two-way	低；未来审计可独立增加	不改变当前主路径，另立只读诊断能力	resolved	covered

evolution_id	scenario_type	source_id	confirmation_status	change_scenario	affected_scope	verification	result_or_gap
EV-CURRENT	evolution	HDR-1	confirmed	新完成或重新同步的正文采用当前契约	task lifecycle、task/artifact comments	lifecycle、platform-comment、platform-sync tests	covered
EV-MIGRATION	migration	HDR-1	not-applicable	不扫描、不批量转换历史 Issue 评论	历史远端评论	diff 与 backfill 边界回归	not-applicable：人工已排除
EV-ROLLBACK	rollback	plan.md:227	confirmed	回退代码将重新暴露错误链接，但不改写存量远端数据	新 helper 与三处门禁	revert 后既有测试恢复；无 schema 迁移	covered
EV-COMPAT	compatibility	compatibility-policy	confirmed	不保留旧链接双写/兼容读取	当前正文契约	grep 无 shim/双写，危险旧正文 fail closed	covered
EV-OPS	operations	plan.md:195-197	confirmed	维护者重新同步旧正文时收到定位错误	CLI 错误与远端调用边界	line/column/error code 断言、fake client 调用为 0	covered

追踪矩阵

source_id	upstream	reviewed_target	verification	status_or_gap
AC-ARTIFACT	analysis-r2.md:47 lifecycle artifact 引用必须代码化	plan.md:82-90,126-130,203-206	helper + task-event 单元/集成测试	covered
AC-PATH	analysis-r2.md:48,85-86 拒绝明确本地目标且保留有效链接	plan.md:71-80,121-124,206,209	内容策略正反例、platform-comment 与 platform-sync	covered
AC-MENTION	analysis-r2.md:49,87 明确非用户 token 代码化、其他提及保留	plan.md:64-80,86-90,121-129,207-208	task-create 与内容策略测试	gap：task 标题插入点未纳入生成方案
R-MARKDOWN	analysis-r2.md:88 保护 inline/fence/table/HTML/receipt/reference	plan.md:73-79,109-111,121-124	计划仅列 inline/fence 正例	gap：HTML、reference/receipt、转义和具体词法状态没有验证契约
HDR-1	task.md#HDR-1 只修复未来生成/同步内容	plan.md:55,97,210,225	compatibility-budget 检视、backfill 边界测试	covered
HDR-2	task.md#HDR-2 无 GitHub 用户查询	plan.md:56,73,95,105-107,217	fake client endpoint 调用记录	covered
AC-SYNC	analysis-r2.md:52,77-79 保持同源、marker、分片和幂等	plan.md:67,92-97,132-140,195-217	platform-comment/platform-sync 回归	covered

问题清单

阻塞项（必须修复）

（无）

主要问题（建议修复）

PL-1：受控 task 生成遗漏标题中的非用户 token

文件：plan.md:88

场景：用户创建标题含 raw @2x 的任务。renderTask 把 candidate.title 直接写入 task Markdown 标题，而方案只要求格式化 description 和 task input；随后整份 task body 会进入 Issue task 评论。

影响：新任务并未在生成时得到规范表示。若同步前门禁启用，该任务会因自身标题而无法同步；若该门禁入口遗漏，则会继续产生误提及。两种结果都不满足“受控生成内容直接代码化”的验收目标。

证据：lib/task/create.ts:225-232 显示标题、描述和 task input 是三个独立插入点；lib/platform/issue-comments.ts:60-74 显示 task body 整体被发布；plan.md:88,129 只列描述和 task input。

置信度：high

未验证假设：无。问题由静态数据流直接成立，不依赖 GitHub 是否实际把该 token 渲染成链接。

修复方向：在方案中把所有由 task-create 控制且会进入 task 评论的文本字段列成最小字段矩阵，至少将渲染后的 Markdown 标题与 description/task input 一起纳入 formatKnownNonUserTokens；补一个标题含 raw @2x 的 task-create → task-comment 正例，并确认结构化 candidate digest 仍基于原始输入。

PL-2：轻量 Markdown 扫描器缺少上游要求的结构保护契约

文件：plan.md:73-79

场景：同步正文中的候选 token 或本地路径位于 HTML、reference-style link/definition、转义语法或不同长度的 inline/fenced code delimiter 中。已批准分析明确要求保护 HTML 和 receipt/reference 结构，但方案只声明跳过 inline/fenced code，测试清单也只覆盖这两类代码语境。

影响：执行方需要在没有设计边界的情况下自行猜测扫描状态，可能误改/误拒绝安全内容，或漏掉实际可点击的危险目标；这正是该高风险任务要避免的误伤。仅写“未知语义 fail closed”不能替代对安全结构的可观察分类，因为 fail closed 本身也会阻断正常 lifecycle 完成和同步。

证据：analysis-r2.md:88 明列 inline code、code fence、table、HTML、receipt/reference；plan.md:73-79,121-124 只定义 inline/fenced 跳过和有限正反例；plan.md:109-111 以避免误伤这些结构为拒绝 AST 的理由，却没有给轻量扫描器相应的状态和测试契约。

置信度：high

未验证假设：未验证 GitHub 对每一种 HTML/reference 形态的最终渲染；这不影响 finding，因为缺失的是上游已明确要求的结构保护与设计可执行性。

修复方向：补充轻量扫描器的最小状态机和位置契约：明确支持的 inline/fence delimiter、HTML/转义/reference definition 的处理方式，以及哪些结构只检查链接目标、哪些保持原样；在内容策略测试矩阵增加对应正反例和 line/column 诊断断言。无需引入完整 AST 或新依赖。

次要问题（低影响但需闭环）

（无）

非阻塞建议

（无）

人工校验项

（无）

审查分歧账本回写

• 新 finding：PL-1，stage=plan，severity=major，evidence=review-plan.md#PL-1。
• 新 finding：PL-2，stage=plan，severity=major，evidence=review-plan.md#PL-2。
• 本轮无上一轮 plan finding 响应、无 needs-human-decision 升级。

证据原文

• 断言：任务上下文、工作树和本轮产物身份在审查前已锁定。

$ agent-infra-internal task-context resolve -t 4
{"status":"resolved","changed":false,"taskId":"TASK-20260826-184851","taskDir":"/workspace/.agents/workspace/active/TASK-20260826-184851","taskMdPath":"/workspace/.agents/workspace/active/TASK-20260826-184851/task.md","taskState":"active","error":null}
$ agent-infra-internal task-artifact TASK-20260826-184851 inspect --family review-plan
{"status":"ready","changed":false,"requestRef":"TASK-20260826-184851","taskId":"TASK-20260826-184851","taskDir":"/workspace/.agents/workspace/active/TASK-20260826-184851","taskState":"active","family":"review-plan","artifacts":[],"latest":null,"next":{"round":1,"name":"review-plan.md"},"reviewedInput":null,"diagnostics":[],"error":null,"inputs":[{"family":"plan","round":1,"name":"plan.md","path":"/workspace/.agents/workspace/active/TASK-20260826-184851/plan.md","size":17088,"mtimeMs":1788235344679.7876}],"codeMode":null}

• 断言：task-create 标题、描述和 task input 是独立插入点，方案只覆盖后两者。

$ nl -ba lib/task/create.ts | sed -n '220,235p'
   220	    `task_create_key_digest: ${params.keyDigest}`,
   221	    `task_create_candidate_digest: ${params.candidateDigest}`,
   222	    '---'
   223	  ].join('\n');
   224	  let content = params.template.replace(/^---\n[\s\S]*?\n---/, frontmatter);
   225	  content = content.replace('# 任务：[标题]', `# 任务：${candidate.title}`);
   226	  content = content.replace('[清晰简洁地描述任务。]', markdownBlock(candidate.description));
   227	  const sections: Array<[string, keyof TaskCreateCandidateV1['taskInput']]> = [
   228	    ['### 来源', 'sources'], ['### 已确认事实与证据', 'facts'], ['### 约束', 'constraints'],
   229	    ['### 已确认决策', 'decisions'], ['### 候选与否决方案', 'alternatives'],
   230	    ['### 验收标准', 'acceptanceCriteria'], ['### 未决事项', 'openQuestions']
   231	  ];
   232	  for (const [heading, key] of sections) content = replaceEmptySubsection(content, heading, candidate.taskInput[key]);
   233	  content = content.replace('- **关联 Issue**：#XXX', '- **关联 Issue**：N/A');
   234	  content = content.replace('- **关联 PR**：#XXX', '- **关联 PR**：N/A');
   235	  content = content.replace('- **分支**：`feature/xxx`', `- **分支**：\`${branch}\``);
$ nl -ba .agents/workspace/active/TASK-20260826-184851/plan.md | sed -n '86,90p;126,130p'
    86	### task 内容生成与 artifact 完成门禁
    87	
    88	- 修改 `lib/task/create.ts:172-241`：对描述和 task input 的正文渲染调用 `formatKnownNonUserTokens`，确保新建 task 的 `@2x` 在本地源文件中就使用代码文本。候选输入摘要仍基于原始结构化输入，输出保持确定性，不能把格式化结果当作新的外部数据源。
    89	- 修改 `lib/task/artifact-lifecycle.ts:453-470`：`validateCompletedArtifact` 读取已落地的 artifact 内容并调用 `findIssueCommentViolations`。有违规时返回新的 `ARTIFACT_CONTENT_INVALID`，不继续写入 task.md 的产物链接、receipt 或 Activity Log；错误消息带出首个违规位置和可操作修复示例。
    90	- 不在 `writeTask` 中对任意 task 内容做宽泛重写。生命周期自动引用由共享 helper 负责；其他手写内容由同步前校验保护，避免在所有 task mutation 中引入隐式正文变化。
   126	2. **实现共享策略和自动引用格式**
   127	   - 新增 `lib/task/issue-comment-content.ts`。
   128	   - 修改 `lib/task/artifact-lifecycle.ts` 的引用生成；同步扩展 artifact 错误类型和完成校验。
   129	   - 修改 `lib/task/create.ts` 的描述/task input 渲染。
   130	   - verify：生命周期 helper 输出不可点击代码文本；artifact 违规在 task event 完成前失败且不改 task.md。

• 断言：task 评论会发布完整 task body，因此标题遗漏会进入同步边界。

$ nl -ba lib/platform/issue-comments.ts | sed -n '60,74p'
    60	function renderTaskComment(content: string, taskId: string, agent: string): string {
    61	  const split = splitFrontmatter(content);
    62	  const taskBody = split.frontmatter === null
    63	    ? split.body
    64	    : `<details><summary>元数据 (frontmatter)</summary>\n\n\`\`\`yaml\n---\n${split.frontmatter}\n---\n\`\`\`\n\n</details>\n\n${split.body}`;
    65	  return normalizeCommentContent([
    66	    MARKERS.task(taskId),
    67	    '## 任务文件',
    68	    '',
    69	    `> **${agent}** · ${taskId}`,
    70	    '',
    71	    taskBody.replace(/\n+$/, ''),
    72	    '',
    73	    footer(agent, taskId)
    74	  ].join('\n'));

• 断言：已批准分析要求保护 HTML 和 receipt/reference，但方案及测试清单没有落实相应扫描状态。

$ rg -n "HTML|receipt/reference|行内代码|代码围栏" .agents/workspace/active/TASK-20260826-184851/analysis-r2.md .agents/workspace/active/TASK-20260826-184851/plan.md
.agents/workspace/active/TASK-20260826-184851/analysis-r2.md:88:- **Markdown 结构误判**：链接或 `@2x` 可能位于行内代码、代码围栏、表格、HTML 或 receipt/reference 内容中。方案阶段需要保护已有代码语义和结构化解析，不以自然语言关键词作测试门禁。
.agents/workspace/active/TASK-20260826-184851/plan.md:65:2. 对可由代码控制的 task 创建内容，仅将明确的非用户 token（当前为 `@2x`）在非代码语境下包成行内代码；已有行内代码、代码围栏、真实账号形态提及和普通业务文本不改写。
.agents/workspace/active/TASK-20260826-184851/plan.md:74:- `findIssueCommentViolations(content)`：以轻量 Markdown 词法扫描返回结构化违规项（类型、行、列、token、修复说明），跳过代码围栏和行内代码。检查范围限定为：
.agents/workspace/active/TASK-20260826-184851/plan.md:111:否决。当前项目没有 Markdown 解析依赖，全面重写会误伤有效文档链接、HTML、receipt/reference、表格和代码语义，改动和测试面显著扩大。选定方案只对明确危险模式做轻量词法保护，不能唯一判断的内容保留并 fail closed。

• 断言：任务已绑定 Issue fix: 修复 Issue 评论中的本地路径和误识别链接 #941，且两项既有人工裁决均已闭环。

$ agent-infra-internal platform-issue inspect TASK-20260826-184851
{"status":"no-op","changed":false,"platform":{"type":"github","repository":"fitlab-ai/agent-infra","currentUser":"CodeCasterX"},"resource":{"kind":"issue","number":941},"capabilities":{"authenticated":true,"comment":true,"triage":true,"push":true,"admin":true},"operations":[],"comment":null,"error":null,"task":{"id":"TASK-20260826-184851","issueNumber":941},"issue":{"repository":"fitlab-ai/agent-infra","number":941,"state":"open","title":"fix: 修复 Issue 评论中的本地路径和误识别链接","labels":["status: pending-design-work","type: bug"],"assignees":["CodeCasterX"],"milestone":"0.9.x","issueType":"Bug","fields":{"Priority":"High","Effort":"Medium"}}}
$ nl -ba .agents/workspace/active/TASK-20260826-184851/task.md | sed -n '124,145p'
   124	## 审查分歧账本
   125	
   126	<!-- 每条 review finding 一行；状态机/证据规则见 .agents/rules/review-handshake.md。阶段推进与 complete-task gate 读取本段。无分歧时保留表头即可。 -->
   127	
   128	| id | stage | round | severity | status | evidence |
   129	|----|-------|-------|----------|--------|----------|
   130	| HD-1 | analysis | - | decision | human-decided | task.md#HDR-1 |
   131	| HD-2 | analysis | - | decision | human-decided | task.md#HDR-2 |
   132	
   133	## 人工裁决
   134	
   135	### HDR-2
   136	
   137	- **原账本 ID**：HD-2
   138	- **裁决时间**：2026-09-01 11:03:21+08:00
   139	- **裁决结果**：选择方案 A：正常生成和同步流程不查询 GitHub，只对明确的非用户语义 token（如 @2x）使用代码格式，并保留账号形态但意图不明的提及。若未来需要账号状态判断，另设独立的只读审计/诊断动作，仅报告结果，不改写内容，也不阻塞正常同步。理由：账号是否存在不能证明作者是否有意提及，且查询会引入网络、权限和限流依赖。
   140	
   141	### HDR-1
   142	
   143	- **原账本 ID**：HD-1
   144	- **裁决时间**：2026-09-01 09:18:59+08:00
   145	- **裁决结果**：选择方案 A：仅修复未来生成/同步的内容，不批量回填历史 Issue 评论。理由：当前任务只明确未来规则，未提供可安全批量回填所需的 Issue 范围、必要性、期限和退出条件。

自我质疑

• 未执行拟议实现或测试，因此不能证明轻量扫描器一定会误判某个具体 HTML/reference 样例；PL-2 判断的是方案没有提供足以让实现和验证不靠猜测的结构契约。若修订方案能证明这些结构由既有 parser/utility 统一处理并补上对应测试，该 finding 可关闭。
• 没有在真实 GitHub UI 重新验证 raw @2x 的渲染；PL-1 依据已批准需求和静态数据流成立，即使平台渲染行为变化，受控生成字段覆盖仍应与方案自己的静态门禁契约一致。
• task.md 的“上下文”展示仍写关联 Issue 为 N/A，但 frontmatter 与 typed platform-issue inspect 已确认 issue_number=941。本轮以 typed 关联为事实源；该展示漂移不影响技术方案 finding，也未在 review-plan 技能中越权修复。

亮点

• 方案坚持本地文件为唯一正文事实源，没有引入远端专属重写、双写或隐藏兼容分支。
• 同步前 fail-closed、line/column 诊断和“远端调用记录为 0”的验证目标可操作，能保护 marker、分片和幂等状态机不受部分副作用污染。
• HDR-1/HDR-2 已被准确落实为 current-only 和无 GitHub 用户查询，备选方案的拒绝理由与上游裁决一致。

与方案一致性

• 方案已完整覆盖所有受控 task 正文生成入口
• Markdown 结构保护已形成可执行、可验证的最小词法契约
• 没有意外的范围扩张

结论与建议

审查决定

• 通过
• 需要修改
• 拒绝

下一步

聚焦修订 plan.md：补齐 task 标题字段的代码化入口，并把 HTML/reference/转义/代码 delimiter 的最小扫描状态和测试矩阵写清；不改变 current-only、单一正文事实源或无用户 API 的总体设计。

---

由 codex 自动生成 · 内部追踪：TASK-20260826-184851

[CodeCasterX]

技术方案审查（Round 2）

codex · TASK-20260826-184851

技术方案审查报告

• 审查轮次：第 2 轮
• 产物文件：review-plan-r2.md
• 审查输入：
  • plan.md

状态核对

$ git status -s
(empty)
$ ls -la .agents/workspace/active/TASK-20260826-184851/
f	11139	analysis-r2.md
f	14000	analysis.md
f	17088	plan.md
f	20070	review-analysis-r2.md
f	15701	review-analysis.md
f	26472	review-plan.md
f	11238	task.md
$ tail .agents/workspace/active/TASK-20260826-184851/task.md
<!-- 由 complete-task 勾选 -->

## 产物生命周期收据

| event | output | input | input_sha256 | completed_at |
| --- | --- | --- | --- | --- |
| review-analysis.completed | review-analysis.md | analysis.md | 97fcedfccf6055b5e944e74cf861475b4953b21c973552c229125c9528a3a1b8 | 2026-09-01 00:19:49+08:00 |
| review-analysis.completed | review-analysis-r2.md | analysis-r2.md | 768c50cc4abf90b67c74139beaaa8192d648da00658dc88fbe42a77523df5f0e | 2026-09-01 11:22:36+08:00 |
| review-plan.completed | review-plan.md | plan.md | 40921ec8e900f13eeb51dc1290bee3efba7dcbebda87f7d719fe68168756933b | 2026-09-01 12:57:43+08:00 |

审查摘要

• 审查者：codex
• 审查时间：2026-09-01 14:03:15+08:00
• 审查范围：未修订的 plan.md、上一轮 review-plan.md、已批准分析、task ledger、Issue fix: 修复 Issue 评论中的本地路径和误识别链接 #941，以及 task-create / task-comment 相关源码入口
• 总体结论：需要修改
• 发现（AI 可处理）：0 阻塞项，2 主要，0 次要 / 人工校验：0

检视覆盖声明

pass_id	scope	evidence	result	gaps_or_assumptions
pass-1	原始任务、已批准分析、方案输入、Issue #941 与源码入口	analysis-r2.md:43-123；plan.md；lib/task/create.ts:225-232；lib/platform/issue-comments.ts:60-74；typed Issue inspect	原始事实与上一轮相比未变化	本轮没有新的 plan artifact
pass-2	方案修订身份和上一轮 finding 响应追踪	task snapshot；artifact inspect；sha256sum plan.md；task.md:130-135,184-188,199-205	最高方案仍为 Round 1 plan.md，digest 等于上一轮 receipt；PL-1/PL-2 仍为 open，未见执行方响应	不把重复触发 review 当作方案修订
pass-3	compatibility-budget 与架构专项复核	plan.md:55-97,195-227；compatibility policy	current-only、单一事实源和跨组件 fail-closed 架构仍合理；两个既有 gap 未改变	code 阶段专用镜头仍不适用
pass-4	对 PL-1、PL-2 及“可放行”候选结论进行反证	plan.md:73-79,88,121-130；analysis-r2.md:88；lib/task/create.ts:225-232	未找到标题字段覆盖，也未找到 HTML/reference/转义词法契约；无法撤回或降级两项 finding	未执行业务代码或测试
pass-5	finding、manual-validation、advisory 与 verdict 收敛	task.md:130-135；本报告 #PL-1、#PL-2	保持 2 个 major open；无新 finding、无人工校验、无人工裁决	最终计数由唯一一次 finalizer 快照确定

lens_id	trigger_evidence	loaded	result
compatibility-budget	plan.md:55,97,210,225 继续采用 current-only 且不加旧格式双写/shim	yes	兼容预算合规；本轮无变化
documentation-antipatterns	plan 阶段且无实现 diff	not-applicable	code 阶段镜头
testing-discipline	plan 阶段且无测试 diff	not-applicable	code 阶段镜头；本轮仅审查测试策略完整性
security-risks	无认证、授权、凭据或用户查询设计变化	not-applicable	code 阶段镜头
migration-risks	无 schema、持久化或迁移设计变化	not-applicable	code 阶段镜头
concurrency-risks	保留既有同步状态机，无新增共享并发状态	not-applicable	code 阶段镜头
cross-platform-risks	方案列出 Windows/UNC 路径但无代码 diff	not-applicable	code 阶段重新触发

技术方案架构覆盖

assessment_id	classification	trigger_evidence	review_depth	result_or_gap
architecture-significance	architecture-significant	plan.md:62-97 仍改变 task lifecycle → platform-comment → verification-sync 的跨组件控制流及错误行为	mini-atam	总体架构仍可行；task 生成字段覆盖与 Markdown 词法契约仍有 gap

quality_scenario_id	source_id	business_driver	quality_attribute	priority	stimulus	context	expected_response	measure	result_or_gap
QS-CORRECTNESS	AC-ARTIFACT, AC-PATH	避免错误本地链接	correctness	high	lifecycle 或 artifact 产生本地引用	完成及同步前	自动引用代码化，危险手写链接在远端 I/O 前失败	无新 canonical artifact 链接且平台调用为 0	covered
QS-PRECISION	AC-MENTION, R-MARKDOWN	避免误提及且不误伤 Markdown	precision	high	task/artifact 含 @2x、HTML、reference 或代码边界	生成、完成、同步	明确 token 代码化或可操作拒绝，安全结构保持	字段矩阵和结构正反例全部通过	gap：PL-1、PL-2 未处理
QS-OPERABILITY	HDR-1, AC-SYNC	current-only 下保持可诊断	operability	high	重新同步旧危险正文	升级后的当前路径	fail closed 并定位，不产生远端副作用	typed error 含位置、fake client 调用为 0	covered

decision_id	selected_option	alternative_option	benefit	cost	assumption	rejection_reason	result_or_gap
D-CONTENT	生成规范表示 + 本地/同步门禁	远端 payload 改写	单一事实源、正文可验证	旧正文需显式修复	HDR-1 已批准 current-only	远端改写导致正文漂移	covered
D-LEXER	无依赖轻量扫描	完整 AST 重写	改动集中、可 fail closed	自定义词法边界必须明确	危险模式有限	AST 改动面过大	gap：结构状态和测试仍不完整
D-IDENTITY	只处理明确 @2x，不查用户 API	正常路径查询账号	确定、无网络依赖	不审计账号状态	HDR-2 已批准	存在性不能证明意图	covered

risk_id	decision_id	risk_or_sensitivity	affected_quality_attributes	tradeoff	mitigation_or_validation	result_or_gap
R-FIELD-COVERAGE	D-CONTENT	task 标题绕过受控格式化	correctness, operability	小变更面留下同步失败入口	覆盖所有进入 task comment 的受控字段	gap：PL-1
R-MARKDOWN	D-LEXER	HTML/reference/转义/delimiter 边界误判	precision, correctness	轻量实现承担边界定义责任	最小状态机与正反例矩阵	gap：PL-2
R-REMOTE	D-CONTENT	校验晚于平台读取	operability	调整调用顺序	校验先于 context/list 并断言调用为 0	covered

decision_id	door_type	reversal_cost	migration_or_rollback	decision_status	result_or_gap
D-CONTENT	two-way	中；回退会恢复错误链接	回退 helper/门禁，不需数据逆迁移	resolved	covered
D-LEXER	two-way	低至中	集中收窄策略并重新同步本地源文件	resolved	gap：无需人工裁决，但必须补设计
D-IDENTITY	two-way	低	未来另立只读审计	resolved	covered

evolution_id	scenario_type	source_id	confirmation_status	change_scenario	affected_scope	verification	result_or_gap
EV-CURRENT	evolution	HDR-1	confirmed	新生成/重新同步采用当前契约	lifecycle 与评论	lifecycle/platform tests	covered
EV-MIGRATION	migration	HDR-1	not-applicable	不批量转换历史评论	历史远端数据	backfill 边界回归	not-applicable：人工已排除
EV-ROLLBACK	rollback	plan.md:227	confirmed	回退重新暴露错误链接	helper 与门禁	无 schema 逆迁移	covered
EV-COMPAT	compatibility	compatibility-policy	confirmed	不保留旧链接双写/兼容读取	当前正文契约	grep 无 shim/双写	covered
EV-OPS	operations	plan.md:195-197	confirmed	旧正文重新同步得到定位错误	CLI 与远端边界	line/column 和 0 调用断言	covered

追踪矩阵

source_id	upstream	reviewed_target	verification	status_or_gap
AC-ARTIFACT	analysis-r2.md:47 artifact 引用代码化	plan.md:82-90,126-130,203-206	helper/task-event 测试	covered
AC-PATH	analysis-r2.md:48,85-86 拒绝本地目标且保留有效链接	plan.md:71-80,121-124,206,209	策略与平台正反例	covered
AC-MENTION	analysis-r2.md:49,87 明确 token 代码化	plan.md:64-80,88,121-129,207-208	task-create/content policy	gap：标题未进入格式化字段集合
R-MARKDOWN	analysis-r2.md:88 保护 code/table/HTML/receipt/reference	plan.md:73-79,109-111,121-124	仅列 inline/fence	gap：HTML/reference/转义与 delimiter 契约缺失
HDR-1	task.md#HDR-1 current-only	plan.md:55,97,210,225	compatibility-budget	covered
HDR-2	task.md#HDR-2 无用户查询	plan.md:56,73,95,105-107,217	fake endpoint 记录	covered
REVIEW-R1	review-plan.md#PL-1,#PL-2	未修订的 plan.md	digest + task ledger	gap：两项均未响应、未修订

问题清单

阻塞项（必须修复）

（无）

主要问题（建议修复）

PL-1：受控 task 生成仍遗漏标题中的非用户 token

文件：plan.md:88

场景：任务标题含 raw @2x；candidate.title 独立写入 Markdown 标题，方案仍只覆盖 description 和 task input。

影响：新任务不能在生成时形成规范正文；同步前门禁会阻断该任务，或入口遗漏时继续发布误提及。

证据：当前 plan.md digest 与上一轮 receipt 相同；plan.md:88,129 仍只列 description/task input；lib/task/create.ts:225-232 仍显示标题是独立插入点；lib/platform/issue-comments.ts:60-74 发布完整 task body。

置信度：high

未验证假设：无。

修复方向：先执行 plan-task 生成新的 plan artifact，在方案中将渲染后的标题纳入受控字段矩阵，并增加标题含 raw @2x 的 task-create → task-comment 正例，同时保持 candidate digest 基于原始输入。

PL-2：轻量 Markdown 扫描器仍缺少结构保护契约

文件：plan.md:73-79

场景：候选 token/路径位于 HTML、reference definition、转义语法或不同长度的 inline/fence delimiter 中；分析要求保护这些结构，方案仍只声明跳过 inline/fenced code。

影响：实现方必须自行猜测扫描状态，可能误拒绝安全内容或漏掉危险目标，正常 lifecycle 完成与同步仍可能被不精确门禁阻断。

证据：analysis-r2.md:88 明列 HTML 与 receipt/reference；未变的 plan.md:73-79,121-124 没有相应状态和测试矩阵；plan.md:109-111 用避免误伤这些结构否决 AST，却未给轻量替代契约。

置信度：high

未验证假设：未验证每种结构的 GitHub 最终渲染；finding 针对的是方案可执行性，不依赖具体平台渲染结果。

修复方向：在新 plan artifact 中写明最小扫描状态机、delimiter/HTML/转义/reference 处理规则，以及对应保持/拒绝正反例和 line/column 断言；无需引入完整 AST。

次要问题（低影响但需闭环）

（无）

非阻塞建议

（无）

人工校验项

（无）

审查分歧账本回写

• PL-1、PL-2 当前均为 open。本轮没有新的 plan artifact，也没有执行方 accepted / adjusted / refuted / cannot-judge 响应，因此不调用 finding-review 伪造握手轮次，不新增重复 finding。
• 最终摘要应继续从现有 ledger 得到 0 blocker、2 major、0 minor、0 待人工裁决。

证据原文

• 断言：本轮仍审查 Round 1 plan.md，没有新的方案产物。

$ agent-infra-internal task-artifact TASK-20260826-184851 inspect --family review-plan
{"status":"ready","changed":false,"requestRef":"TASK-20260826-184851","taskId":"TASK-20260826-184851","taskDir":"/workspace/.agents/workspace/active/TASK-20260826-184851","taskState":"active","family":"review-plan","artifacts":[{"family":"review-plan","round":1,"name":"review-plan.md","path":"/workspace/.agents/workspace/active/TASK-20260826-184851/review-plan.md","size":26472,"mtimeMs":1788238641993.7766}],"latest":{"family":"review-plan","round":1,"name":"review-plan.md","path":"/workspace/.agents/workspace/active/TASK-20260826-184851/review-plan.md","size":26472,"mtimeMs":1788238641993.7766},"next":{"round":2,"name":"review-plan-r2.md"},"reviewedInput":{"family":"plan","round":1,"name":"plan.md","path":"/workspace/.agents/workspace/active/TASK-20260826-184851/plan.md","size":17088,"mtimeMs":1788235344679.7876},"diagnostics":[],"error":null,"inputs":[{"family":"plan","round":1,"name":"plan.md","path":"/workspace/.agents/workspace/active/TASK-20260826-184851/plan.md","size":17088,"mtimeMs":1788235344679.7876}],"codeMode":null}
$ sha256sum .agents/workspace/active/TASK-20260826-184851/plan.md
40921ec8e900f13eeb51dc1290bee3efba7dcbebda87f7d719fe68168756933b  .agents/workspace/active/TASK-20260826-184851/plan.md

• 断言：当前方案 digest 等于上一轮 review receipt 和本轮 started 输入 digest，且 ledger findings 尚未响应。

$ nl -ba .agents/workspace/active/TASK-20260826-184851/task.md | sed -n '19,21p;130,135p;199,205p'
    19	issue_number: 941
    20	review_input_artifact: plan.md
    21	review_input_sha256: 40921ec8e900f13eeb51dc1290bee3efba7dcbebda87f7d719fe68168756933b
   130	| id | stage | round | severity | status | evidence |
   131	|----|-------|-------|----------|--------|----------|
   132	| HD-1 | analysis | - | decision | human-decided | task.md#HDR-1 |
   133	| HD-2 | analysis | - | decision | human-decided | task.md#HDR-2 |
   134	| PL-1 | plan | 1 | major | open | review-plan.md#PL-1 |
   135	| PL-2 | plan | 1 | major | open | review-plan.md#PL-2 |
   199	## 产物生命周期收据
   200	
   201	| event | output | input | input_sha256 | completed_at |
   202	| --- | --- | --- | --- | --- |
   203	| review-analysis.completed | review-analysis.md | analysis.md | 97fcedfccf6055b5e944e74cf861475b4953b21c973552c229125c9528a3a1b8 | 2026-09-01 00:19:49+08:00 |
   204	| review-analysis.completed | review-analysis-r2.md | analysis-r2.md | 768c50cc4abf90b67c74139beaaa8192d648da00658dc88fbe42a77523df5f0e | 2026-09-01 11:22:36+08:00 |
   205	| review-plan.completed | review-plan.md | plan.md | 40921ec8e900f13eeb51dc1290bee3efba7dcbebda87f7d719fe68168756933b | 2026-09-01 12:57:43+08:00 |

• 断言：PL-1 的标题数据流和 PL-2 的结构契约缺口仍存在。

$ nl -ba lib/task/create.ts | sed -n '224,232p'
   224	  let content = params.template.replace(/^---\n[\s\S]*?\n---/, frontmatter);
   225	  content = content.replace('# 任务：[标题]', `# 任务：${candidate.title}`);
   226	  content = content.replace('[清晰简洁地描述任务。]', markdownBlock(candidate.description));
   227	  const sections: Array<[string, keyof TaskCreateCandidateV1['taskInput']]> = [
   228	    ['### 来源', 'sources'], ['### 已确认事实与证据', 'facts'], ['### 约束', 'constraints'],
   229	    ['### 已确认决策', 'decisions'], ['### 候选与否决方案', 'alternatives'],
   230	    ['### 验收标准', 'acceptanceCriteria'], ['### 未决事项', 'openQuestions']
   231	  ];
   232	  for (const [heading, key] of sections) content = replaceEmptySubsection(content, heading, candidate.taskInput[key]);
$ rg -n "HTML|receipt/reference|行内代码|代码围栏|description|task input" .agents/workspace/active/TASK-20260826-184851/analysis-r2.md .agents/workspace/active/TASK-20260826-184851/plan.md
.agents/workspace/active/TASK-20260826-184851/plan.md:65:2. 对可由代码控制的 task 创建内容，仅将明确的非用户 token（当前为 `@2x`）在非代码语境下包成行内代码；已有行内代码、代码围栏、真实账号形态提及和普通业务文本不改写。
.agents/workspace/active/TASK-20260826-184851/plan.md:74:- `findIssueCommentViolations(content)`：以轻量 Markdown 词法扫描返回结构化违规项（类型、行、列、token、修复说明），跳过代码围栏和行内代码。检查范围限定为：
.agents/workspace/active/TASK-20260826-184851/plan.md:88:- 修改 `lib/task/create.ts:172-241`：对描述和 task input 的正文渲染调用 `formatKnownNonUserTokens`，确保新建 task 的 `@2x` 在本地源文件中就使用代码文本。候选输入摘要仍基于原始结构化输入，输出保持确定性，不能把格式化结果当作新的外部数据源。
.agents/workspace/active/TASK-20260826-184851/plan.md:111:否决。当前项目没有 Markdown 解析依赖，全面重写会误伤有效文档链接、HTML、receipt/reference、表格和代码语义，改动和测试面显著扩大。选定方案只对明确危险模式做轻量词法保护，不能唯一判断的内容保留并 fail closed。
.agents/workspace/active/TASK-20260826-184851/plan.md:129:   - 修改 `lib/task/create.ts` 的描述/task input 渲染。
.agents/workspace/active/TASK-20260826-184851/analysis-r2.md:88:- **Markdown 结构误判**：链接或 `@2x` 可能位于行内代码、代码围栏、表格、HTML 或 receipt/reference 内容中。方案阶段需要保护已有代码语义和结构化解析，不以自然语言关键词作测试门禁。

自我质疑

• 用户再次触发的是 review-plan，不是 plan-task；本技能不得代替执行方修改方案。若用户原意是先修订方案，本轮仍必须按实际 artifact 身份审查，不能把不存在的 plan-r2.md 当作输入。
• 未对 PL-1/PL-2 调用 finding-review，因为 ledger 没有执行方响应状态可复核。若核心工作流要求 open finding 的每轮证据都迁移到最新 review artifact，应由协议或 typed intent 明确；当前 handshake 规定 finding-review 用于复核响应，不应伪造一次握手。
• 未在真实 GitHub UI 复测 Markdown 渲染；两项 finding 都由未变方案与静态数据流成立。

亮点

• 原方案的 current-only、单一正文事实源、同步前 fail-closed 和无 GitHub 用户查询边界仍然清晰。
• typed artifact inspect 与 SHA receipt 能明确区分“再次审查”与“方案已修订”，避免错误关闭 findings。
• 两项问题均可通过一次聚焦 plan-task 修订解决，不需要推翻整体架构或新增人工裁决。

与方案一致性

• 方案已完整覆盖所有受控 task 正文生成入口
• Markdown 结构保护已形成可执行、可验证的最小词法契约
• 没有意外的范围扩张

结论与建议

审查决定

• 通过
• 需要修改
• 拒绝

下一步

先执行 plan-task 产出新的方案轮次，逐条响应并修订 PL-1、PL-2；随后重新运行 review-plan。在新 plan artifact 出现前，重复审查同一 plan.md 不会关闭现有 findings。

---

由 codex 自动生成 · 内部追踪：TASK-20260826-184851

[CodeCasterX]

技术方案（Round 2）

codex · TASK-20260826-184851

技术方案

• 方案轮次：Round 2
• 产物文件：plan-r2.md
• 输入分析：analysis-r2.md
• 上一轮方案审查：review-plan-r2.md（Changes Requested：PL-1、PL-2）
• 需求分析审查：review-analysis-r2.md（Approved）

状态核对

$ git status -s
(empty)
$ ls -la .agents/workspace/active/TASK-20260826-184851/
f	11139	analysis-r2.md
f	14000	analysis.md
f	17088	plan.md
f	20070	review-analysis-r2.md
f	15701	review-analysis.md
f	19952	review-plan-r2.md
f	26472	review-plan.md
f	11707	task.md
$ tail .agents/workspace/active/TASK-20260826-184851/task.md

## 产物生命周期收据

| event | output | input | input_sha256 | completed_at |
| --- | --- | --- | --- | --- |
| review-analysis.completed | review-analysis.md | analysis.md | 97fcedfccf6055b5e944e74cf861475b4953b21c973552c229125c9528a3a1b8 | 2026-09-01 00:19:49+08:00 |
| review-analysis.completed | review-analysis-r2.md | analysis-r2.md | 768c50cc4abf90b67c74139beaaa8192d648da00658dc88fbe42a77523df5f0e | 2026-09-01 11:22:36+08:00 |
| review-plan.completed | review-plan.md | plan.md | 40921ec8e900f13eeb51dc1290bee3efba7dcbebda87f7d719fe68168756933b | 2026-09-01 12:57:43+08:00 |
| review-plan.completed | review-plan-r2.md | plan.md | 40921ec8e900f13eeb51dc1290bee3efba7dcbebda87f7d719fe68168756933b | 2026-09-01 14:05:33+08:00 |

方案目标与边界

问题理解

当前 lifecycle helper 将 artifact 文件名写成 Markdown 相对链接；task/artifact 评论又直接发布本地正文，因此 GitHub 会把本地文件引用解析为 Issue 下的错误链接。另一个确定问题是非用户语义的 @2x 可能被 GitHub 自动渲染为用户提及。本轮审查确认上一版方案还有两个执行缺口：任务标题没有纳入受控格式化字段，轻量 Markdown 扫描的结构边界没有形成可执行契约。

方案必须让本地生成结果、完成事件门禁、评论同步和 platform-sync 使用同一正文表示，并保护有效链接、代码语境和真实提及。

目标

• 生命周期自动写入 task.md 的 artifact 引用使用“描述：文件名”的代码文本，不再生成指向 Issue 相对地址的 Markdown 链接。
• task 创建时统一处理标题、描述和全部 task input 列表项中的明确非用户 token（当前为 @2x）；候选摘要仍使用原始结构化输入。
• 对 Issue 评论同步边界内的明确危险本地链接和未代码化的非用户 token 提供确定性约束，避免错误内容进入 GitHub。
• 本地文件是唯一正文事实源；同步层只封装、分片、发布和校验，不对远端 payload 做隐藏改写。
• 正常生成和同步不查询 GitHub 用户 API；账号形态但意图不明的提及原样保留。
• 只处理未来生成或重新同步的内容，不新增历史 Issue 评论扫描或批量回填流程。

非目标

• 不处理账号改名、删除或不可访问状态，不实现 GitHub 账号存在性判断。
• 不修改 README、归档 manifest 或其他正式项目文档中的有效链接。
• 不删除或重定义已有 platform-comment backfill 命令；本任务不调用它来批量修复历史评论。
• 不新增旧格式双写、同步回退、adapter、shim 或并行正文事实源。
• 不用完整 Markdown AST 重写全部文档；只实现本任务所需的有限词法契约。

约束条件

• 本地 task/artifact Markdown 是唯一正文事实源，远端同步不得单独改写内容。
• 只处理未来生成或重新同步的当前内容，不批量编辑历史 Issue 评论。
• 正常生成和同步不查询 GitHub 用户状态；不确定的账号形态提及必须保留。
• 有效外链、Issue/PR/commit、anchor 和正式文档链接不得被泛化替换。
• 必须保持 marker、分片、幂等、陈旧分片删除和 platform-sync 正文相等性契约。
• 词法扫描按 1-based 行号和列号报告首个违规项；扫描器不负责解释完整 Markdown，只负责受控结构和危险目标。

对上一轮审查的响应

PL-1：受控 task 生成仍遗漏标题中的非用户 token [adjusted]

• 处置状态：adjusted。adjusted 表示接受问题成立并修改方案边界，而不是仅在实现阶段口头补充。
• 核实证据：lib/task/create.ts:225-232 中 candidate.title 独立替换任务标题，上一版方案只列 description 和 task input；lib/platform/issue-comments.ts:60-74 发布完整 task 正文，因此标题会进入 Issue 评论。
• 方案修订：将受控生成字段明确扩展为 candidate.title、candidate.description 及 taskInput 的全部七类列表项。渲染标题前调用 formatKnownNonUserTokens；描述和列表项沿用既有 Markdown 处理后再使用同一格式化策略。格式化只作用于渲染副本，task_create_candidate_digest 仍基于原始候选输入。
• 验证证据：新增标题包含 raw @2x 的 task-create 正例，断言生成的 # 任务：... 中为 `@2x`；再同步该 task，断言评论正文与本地 task 正文一致。新增列表项和描述的字段矩阵，确保七类列表字段不遗漏。

PL-2：轻量 Markdown 扫描器仍缺少结构保护契约 [adjusted]

• 处置状态：adjusted。保留无第三方依赖的轻量扫描方向，但补充最小状态机、目标分类、HTML/reference/转义规则和每类正反例。
• 核实证据：analysis-r2.md:88 明确要求保护 code、table、HTML、receipt/reference；上一版 plan.md 只声明跳过 inline/fenced code，没有说明 delimiter、HTML、reference 和 escaped syntax 的边界。
• 方案修订：findIssueCommentViolations 采用逐字符、逐行扫描，维护 fenced code、inline code、HTML comment、Markdown link/reference 和 escaped punctuation 的最小状态；所有 link destination 与 HTML href/src 统一经过危险目标分类器。具体契约见“共享内容策略”。
• 验证证据：新增不同长度的 backtick/tilde fence 和 inline delimiter、HTML comment/tag、reference definition/reference use、转义括号与 @ 的正反例；危险目标断言首个违规项的 line/column，安全结构断言正文原样保持。

技术方法

采用“生成时使用规范表示 + 源文件写入前的静态约束 + 同步前 fail-closed 校验”的组合：

1. 自动 artifact 引用在共享生成 helper 中直接生成代码文本。
2. 对代码拥有的 task 输入字段统一执行明确 token 格式化，覆盖标题、描述和全部 task input 列表项。
3. 对 agent 直接写入的 artifact Markdown，不在同步阶段自动改写。artifact 完成事件和直接评论同步在本地发现危险链接或未代码化 @2x 时 fail closed，并返回行号、列号和修复建议。
4. 平台同步和 platform-sync 验证继续使用修复后的本地原文；验证仍比较同一份正文，不引入“本地一份、远端另一份”的转换层。

共享内容策略

新增无平台依赖的 lib/task/issue-comment-content.ts，供 task、artifact 和平台代码共同使用：

• formatKnownNonUserTokens(content)：只在受控正文的代码围栏和行内代码之外，把明确的 raw @2x 包为 `@2x`；重复执行幂等。转义的 \@2x、`@2x`、@alice、邮箱和其他未知 @ 文本保持原样，不访问网络。
• findIssueCommentViolations(content)：返回结构化违规项，至少包含 kind、1-based line、1-based column、token 和 message。它只报告明确危险链接或未代码化的 raw @2x，不负责改写正文。

最小 Markdown 词法契约

扫描器按以下顺序处理输入；未被识别为受控结构的普通字符保持原样：

1. 转义字符：反斜杠转义的 Markdown 标点（包括 \[, \], \(, \), \``` 、\@）按普通文本跳过，不开启或关闭 link/code 状态；因此 \@2x 不报告违规。
2. fenced code：行首允许最多三个空格；以三个或更多连续 backtick 或 tilde 开启围栏，记录字符类型和 delimiter 长度。只有同类型且长度不小于 opener 的行级 delimiter 才关闭围栏；围栏内全部内容（包括 HTML、reference 和 @2x）跳过。不同长度的 opener/closer 不得提前结束围栏。
3. inline code：围栏外遇到未转义的 backtick run 时，寻找同长度的未转义 closing run；匹配区间内全部内容跳过。不同长度的 delimiter 不配对，未闭合 run按普通文本保留，不扫描其内部的 link 或 @2x。
4. HTML：HTML comment <!-- ... --> 内不扫描 Markdown 语法；普通 HTML tag 不把其中的方括号当 Markdown link，但检查 href/src 属性值，并对其目标使用同一危险目标分类器。安全 HTML 属性保留；指向本地或 canonical artifact 的目标报告违规。
5. Markdown inline/reference link：解析未转义的 [label](destination)、[label][reference]、[reference]: destination 和 collapsed reference 形式的目标。label、reference id 内允许普通文本，但 destination 统一分类；不完整或无法唯一解析的 link 语法不猜测改写，只有其中已明确识别出的危险目标才报告。
6. 表格、receipt 和普通文本：表格分隔线、frontmatter/receipt 中的普通文本不因位置被泛化替换；其中若明确出现可解析的危险 Markdown link 或 HTML URL，仍按上述规则报告。结构化 identity 文本只在其目标实际构成 link 时触发。

危险目标分类器拒绝以下目标：canonical artifact basename（如 analysis.md、plan-r2.md）、包含任务 workspace/active 路径的引用、/workspace/、Unix 用户目录、临时目录、Windows drive path 和 UNC path。它保留 https://、mailto:、Issue/PR/commit URL、#anchor 以及普通项目文档的有效相对链接。无法唯一判断为危险目标的普通文本不改写、不因账号状态查询而失败。

formatKnownNonUserTokens 仅用于代码拥有的 task 渲染；artifact 和同步路径只使用 findIssueCommentViolations 拒绝不安全源文件，避免把“同步修复”误做成远端专属变换。

自动 artifact 引用

修改 lib/task/artifact-lifecycle.ts:473-501：保留现有 artifact family、round、placeholder 和幂等判断，仅把最终引用从 [label](artifact.md) 改为 ${label}：\artifact.md`。lib/task/events.ts和lib/task/activity-intent.ts` 继续调用同一个 helper，因此普通生命周期完成和 PR review 完成路径共享新规则。

task 内容生成与 artifact 完成门禁

• 修改 lib/task/create.ts:172-241：在生成任务正文时，对标题、描述和 taskInput 七类列表项统一调用 formatKnownNonUserTokens。候选输入摘要仍基于原始结构化输入，输出保持确定性，不能把格式化结果当作新的外部数据源。
• 修改 lib/task/artifact-lifecycle.ts:453-470：validateCompletedArtifact 读取已落地 artifact 内容并调用 findIssueCommentViolations。有违规时返回新的 ARTIFACT_CONTENT_INVALID，不继续写入 task.md 的产物链接、receipt 或 Activity Log；错误消息带出首个违规位置和可操作修复示例。
• 不在 writeTask 中对任意 task 内容做宽泛重写。生命周期自动引用由共享 helper 负责；其他手写内容由完成事件和同步前校验保护，避免在所有 task mutation 中引入隐式正文变化。

评论同步与验证

• 修改 lib/platform/issue-comments.ts:230-255,308-340：在任何平台读取或写入之前，对 kind=task 的 task 原文和 kind=artifact 的 artifact 原文执行同一静态校验。违规返回现有 COMMENT_PAYLOAD_INVALID 错误形态，禁止 list、create、patch、delete 和 stale-chunk 清理；summary/cancel 的既有正文契约不扩展本任务规则。
• 保留 marker、frontmatter details、artifact 分片、UTF-8 边界、幂等更新、重试和 owner 检查。校验不调用 GitHub 用户接口。
• 修改 lib/platform/verification-sync.ts:604-664：在本地/远端正文相等比较前复用同一违规检查；不对远端正文做替换。这样 platform-sync 不会因远端和本地共同保留危险文本而错误放行。
• HD-1 的 current-only 规则保持不变：不改变历史评论，不在本任务新增 backfill。重新同步只发布当前本地源文件。

方案对比

备选 A：只在 GitHub payload 中替换

否决。它会使本地 task/artifact 与远端评论产生正文差异，破坏 verification-sync 的相等性门禁，也隐藏源文件实际表示。

备选 B：每次同步查询 GitHub 用户状态

否决。HD-2 已明确正常路径不查询账号状态；账号是否存在不能证明作者是否有意提及，且会增加认证、权限、网络、限流和可见性依赖。真实提及原样保留，未来审计另行设计为只读、只报告、非阻塞动作。

备选 C：引入完整 Markdown AST 并重写所有链接

否决。当前项目没有 Markdown 解析依赖，全面重写会扩大改动面并可能误伤有效文档链接、HTML、receipt/reference、表格和代码语义。修订后的轻量扫描器通过明确状态机和正反例控制边界，无法唯一判断的内容不猜测改写。

备选 D：只修改自动 artifact helper，不做内容校验

不足。它能修复自动追加的相对链接，但无法阻止 agent-authored artifact 中的 workspace 链接或 raw @2x 进入 Issue。选定方案增加本地完成门禁和同步前门禁，保证手写内容不会静默发布。

实施步骤

按以下顺序实施，每步都保持可独立验证：

1. 先写内容策略单元测试

   • 覆盖标题、描述和全部 task input 字段的 @2x 代码化、重复执行幂等、inline/fenced code 保护、真实 @alice/邮箱/转义 \@2x 保留。
   • 覆盖不同长度 backtick/tilde fence 和 inline delimiter、HTML comment/tag、inline/reference/collapsed link、转义语法、表格和 receipt 的正反例。
   • 覆盖 canonical artifact、workspace/用户目录/临时目录/Windows drive/UNC 目标的拒绝，以及外部 URL、Issue/PR/commit、anchor 和有效文档链接的保留。
   • verify：策略测试能区分“需代码化”“需拒绝”“保持原样”三类结果；每个拒绝例断言 kind、line、column 和 token；不使用 GitHub 网络。

2. 实现共享策略和自动引用格式

   • 新增 lib/task/issue-comment-content.ts。
   • 修改 lib/task/artifact-lifecycle.ts 的引用生成；同步扩展 artifact 错误类型和完成校验。
   • 修改 lib/task/create.ts 的标题、描述和列表项渲染。
   • verify：生命周期 helper 输出不可点击代码文本；artifact 违规在 task event 完成前失败且不改 task.md。

3. 接入评论同步和平台验证

   • 修改 lib/platform/issue-comments.ts，把校验放在首次远端 list/context 读取和所有写操作之前。
   • 修改 lib/platform/verification-sync.ts，仅校验本地 task/artifact 内容后继续现有正文比较。
   • verify：违规内容不会产生平台调用；安全内容仍保持 marker、分片、幂等和正文相等行为；不存在用户 API 请求。

4. 更新生命周期、创建、同步和平台回归测试

   • 更新旧的 .md 相对链接断言为代码文本断言。
   • 增加标题 raw @2x 的 task-create → task-comment 正例、所有 task input 字段覆盖、unsafe artifact fail-closed 和结构边界正反例。
   • 保留既有 backfill 测试，确认本任务没有改变 backfill 命令的既有接口和 marker 行为。
   • verify：目标测试通过，且未修改正式文档链接或历史评论 fixture 的预期语义。

5. 执行完整验证并生成实现输入

   • 先运行相关测试，再运行 npm run build 和 npm test。
   • 检查 git diff：仅包含本任务列出的源码和测试文件；确认没有新增 GitHub 用户查询、历史回填或兼容 shim。
   • 完成实现后由 code-task 产出实现报告并创建本地 checkpoint；本方案阶段不执行编码。

文件清单

新建

• lib/task/issue-comment-content.ts - 共享的 Issue 评论 Markdown 词法策略、已知 token 格式化和违规诊断。
• tests/unit/task/issue-comment-content.test.ts - 内容策略的纯单元测试。

修改

• lib/task/artifact-lifecycle.ts - 自动 artifact 引用改为代码文本；完成 artifact 时增加内容约束和错误分类。
• lib/task/create.ts - 新建 task 的标题、描述和 task input 对明确非用户 token 使用代码格式。
• lib/platform/issue-comments.ts - task/artifact 同步前静态校验；保留平台状态机和分片契约。
• lib/platform/verification-sync.ts - platform-sync 比较前校验本地 task/artifact 内容。
• tests/unit/cli/task-artifact-lifecycle.test.ts - helper 输出和 artifact 内容门禁测试。
• tests/unit/platform/issue-comments.test.ts - 同步拒绝危险内容、保留安全内容和无用户查询行为测试。
• tests/integration/cli/task-create.test.ts - 标题、描述和 task input 的 @2x 代码化回归测试。
• tests/integration/cli/task-event.test.ts - 生命周期产物引用新表示和 unsafe artifact fail-closed 测试。
• tests/integration/cli/platform-comment.test.ts - CLI 同步前校验与既有同步状态机回归测试。
• tests/e2e/core/validate-artifact-platform-sync.test.ts - 本地/远端正文一致性及内容约束 e2e 测试。

明确不修改

• lib/task/commands/issue-body.ts：初始 Issue body 的边界保持不变。
• lib/task/write.ts：不对所有 task mutation 做隐式 Markdown 重写。
• lib/platform/completion-backfill.ts：不扩展历史评论回填范围。
• .agents/skills/* 和正式项目文档：本任务通过运行时生成/校验契约完成治理，不改写技能文案或 README 语义。

数据流与错误处理

task create candidate
        │
        ├─ raw candidate digest
        ├─ format title/description/taskInput ──> local task.md
        │                                           │
        │                                           └─ buildArtifactLinkSection -> `artifact.md`
        │
agent-authored artifact.md
        │
        ├─ validateCompletedArtifact ──X unsafe -> actionable local error
        │
        └─ platform-comment sync
             ├─ local policy check ──X unsafe -> no platform operation
             └─ raw local content -> marker/chunk sync -> GitHub comment
                                      │
                                      └─ verification-sync compares same raw content

• 内容策略错误属于不可安全解释的本地输入错误，使用 fail closed，不降级为 warning，不尝试通过账号查询或远端改写“猜测修复”。
• 远端 list、创建、更新、删除和重试的既有错误分类保持不变；本地内容错误在远端 I/O 前返回，避免产生部分外部副作用。
• task 标题的格式化只发生在 task create 的渲染副本；候选 digest 继续对原始候选结构计算，幂等重试仍按原始候选身份判断。

验证策略

行为矩阵

输入	预期行为	验证位置
标题、描述或任一 task input 含 raw @2x	task-create 生成代码文本，候选 digest 不变	content policy、task-create integration
手写 task/artifact 含 raw @2x	完成事件或直接同步 fail closed，并给出位置	artifact lifecycle、platform-comment tests
自动完成 analysis.md / plan.md / code.md 等产物	task.md 写入描述加 `artifact.md`，不可点击	task-artifact-lifecycle.test.ts、task-event.test.ts
inline/fenced code、HTML comment、转义语法含危险样本文本	保持原样，不报告其中的 token/link	content policy tests
HTML href、inline/reference link 含危险本地目标	fail closed，报告 line/column，不产生平台调用	content policy、platform-comment tests
正文含 `@2x`、@alice、邮箱、\@2x	保持原样，不查询 GitHub 用户状态	content policy、platform-comment tests
有效外链、Issue/PR/commit、anchor、正式文档相对链接	保持原语义	content policy、platform-sync e2e
历史已有评论	不扫描、不批量编辑	backfill 边界回归和 diff 检查
同一安全同步重复执行	第二次仍为 no-op	既有 issue-comments/platform-comment 测试

命令级验证

• 目标单元与集成测试：使用 node --test 执行对应测试文件。
• 完整项目验证：npm run build、npm test。
• 平台同步验证：使用现有 fake GitHub client，断言本地/远端正文相等、危险内容失败、平台调用记录为零，并确认没有用户状态查询 endpoint。
• 人工检查：查看生成的 task 评论和 artifact 评论，确认 artifact 文件名及 @2x 不是可点击用户/相对链接；不执行历史评论批量编辑。

影响与风险

• 行为变化：未来生命周期自动引用从可点击相对链接改为代码文本；task 创建生成的标题、描述和 task input 中明确的 @2x 也会规范化为代码文本。
• 错误处理变化：含明确危险内容的 artifact 将在完成或同步时被拒绝，维护者需修复本地源文件；错误不会被隐藏成远端成功。
• 词法风险控制：扫描器只识别有明确边界的 fence、inline code、HTML attribute 和 Markdown link/reference；不同 delimiter 不误配，无法唯一解析的普通文本不猜测改写。
• 外部状态依赖：不增加 GitHub 用户查询，不把认证、权限、网络、限流或账号可见性引入正文生成主路径。
• 历史副作用：不扫描或编辑既有 Issue 评论；HD-1 的 current-only 边界保持不变。
• 兼容性：没有历史数据、旧调用方或不可切换公共协议证据需要兼容；按 current-only 实施，不双写旧链接格式。
• 性能：新增的是对本地评论正文的一次线性扫描，远小于现有平台 I/O；不增加网络请求。
• 可回退性：代码变更集中在共享 helper、内容策略和同步门禁；回退可恢复旧输出，但会重新暴露已修复的 Issue 相对链接问题。

未决问题

无。本轮只修订执行契约以闭环 PL-1、PL-2，没有新增范围裁决；历史回填和账号状态审计仍明确不属于当前实现。

方案结论

修订后的方案覆盖所有受控 task 生成字段，明确了轻量 Markdown 扫描器对 fence、inline code、HTML、reference、转义语法和 delimiter 的最小契约，同时保持本地/远端同源正文、current-only、无 GitHub 用户查询和有效链接保留约束。方案完成后必须重新经过 review-plan 人工审查，批准前不得进入 code-task。

---

由 codex 自动生成 · 内部追踪：TASK-20260826-184851

[CodeCasterX]

技术方案审查（Round 3）

codex · TASK-20260826-184851

技术方案审查报告

• 审查轮次：第 3 轮
• 产物文件：review-plan-r3.md
• 审查输入：
  • plan-r2.md

状态核对

$ git status -s
(empty)
$ ls -la .agents/workspace/active/TASK-20260826-184851/
f	11139	analysis-r2.md
f	14000	analysis.md
f	23244	plan-r2.md
f	17088	plan.md
f	20070	review-analysis-r2.md
f	15701	review-analysis.md
f	19952	review-plan-r2.md
f	26472	review-plan.md
f	12296	task.md
$ tail .agents/workspace/active/TASK-20260826-184851/task.md

## 产物生命周期收据

| event | output | input | input_sha256 | completed_at |
| --- | --- | --- | --- | --- |
| review-analysis.completed | review-analysis.md | analysis.md | 97fcedfccf6055b5e944e74cf861475b4953b21c973552c229125c9528a3a1b8 | 2026-09-01 00:19:49+08:00 |
| review-analysis.completed | review-analysis-r2.md | analysis-r2.md | 768c50cc4abf90b67c74139beaaa8192d648da00658dc88fbe42a77523df5f0e | 2026-09-01 11:22:36+08:00 |
| review-plan.completed | review-plan.md | plan.md | 40921ec8e900f13eeb51dc1290bee3efba7dcbebda87f7d719fe68168756933b | 2026-09-01 12:57:43+08:00 |
| review-plan.completed | review-plan-r2.md | plan.md | 40921ec8e900f13eeb51dc1290bee3efba7dcbebda87f7d719fe68168756933b | 2026-09-01 14:05:33+08:00 |

审查摘要

• 审查者：codex
• 审查时间：2026-09-01 14:15:55+08:00
• 审查范围：plan-r2.md、上一轮两项 finding、已批准分析、task ledger、Issue fix: 修复 Issue 评论中的本地路径和误识别链接 #941、task-create / task-comment 源码入口及 GitHub Flavored Markdown 规范
• 总体结论：需要修改
• 发现（AI 可处理）：0 阻塞项，1 主要，0 次要 / 人工校验：0

检视覆盖声明

pass_id	scope	evidence	result	gaps_or_assumptions
pass-1	已批准需求、plan-r2.md、task/Issue 与源码原始入口	analysis-r2.md:43-52,83-91；plan-r2.md；lib/task/create.ts:225-232；lib/platform/issue-comments.ts:60-74；Issue #941 typed inspect	新方案真实存在且 digest 为 e0bee3...; 独立检视确认总体架构未扩张	本阶段不执行实现或测试
pass-2	需求、PL-1/PL-2 响应、设计与测试追踪	plan-r2.md:43-83,85-181,235-267；task.md:134-139	PL-1 的字段矩阵与 digest 边界已覆盖；PL-2 的有限扫描器、HTML/reference/delimiter 契约已覆盖原 finding	转义 @ 与未闭合 code span 的处理另有新断链
pass-3	compatibility-budget 与架构专项	plan-r2.md:47-67,87-131,258-267；compatibility policy	current-only、单一事实源、同步前 fail-closed 合规；跨组件控制流继续触发 Mini-ATAM	code 阶段镜头不适用
pass-4	对 PL-1/PL-2 修订及放行结论进行反证	plan-r2.md:98-107,155-159,239-249；GFM §6.1、§6.3	接受两项 adjusted 响应；发现 \@2x 和未闭合 backtick 均不是代码 span，却被方案跳过，形成新 PL-3	未直接验证 GitHub 通知副作用；finding 不依赖通知，只依赖“必须使用代码格式”的已批准要求
pass-5	finding、manual-validation、advisory 与 verdict 收敛	本报告 #PL-3；task ledger	PL-1、PL-2 应置 confirmed；新增 1 个 major PL-3；无人工校验/裁决	计数由 finalizer 的同一 ledger 快照确定

lens_id	trigger_evidence	loaded	result
compatibility-budget	plan-r2.md:50,56-58,131,264-267 保持 current-only，无双写/shim	yes	兼容预算合规
documentation-antipatterns	plan 阶段且无实现 diff	not-applicable	code 阶段镜头
testing-discipline	plan 阶段且无测试 diff	not-applicable	code 阶段镜头；本轮只判断计划测试是否充分
security-risks	不改变认证、授权、凭据或用户查询	not-applicable	code 阶段镜头
migration-risks	无 schema、持久化或迁移	not-applicable	code 阶段镜头
concurrency-risks	无新增共享异步状态	not-applicable	code 阶段镜头
cross-platform-risks	计划覆盖 Windows drive/UNC，但尚无代码 diff	not-applicable	code 阶段重新触发

技术方案架构覆盖

assessment_id	classification	trigger_evidence	review_depth	result_or_gap
architecture-significance	architecture-significant	plan-r2.md:87-131 改变 lifecycle → platform-comment → verification-sync 控制流和公开错误行为	mini-atam	架构边界完整；明确 token 的词法安全分类仍有一个 gap

quality_scenario_id	source_id	business_driver	quality_attribute	priority	stimulus	context	expected_response	measure	result_or_gap
QS-CORRECTNESS	AC-ARTIFACT, AC-PATH	避免错误本地链接	correctness	high	lifecycle 或 artifact 含本地引用	完成及同步前	自动引用代码化，危险目标在 I/O 前失败	无新 canonical artifact 链接且平台调用为 0	covered
QS-PRECISION	AC-MENTION, R-MARKDOWN	明确 token 必须代码化且不误伤真实提及	precision	high	正文出现 raw、escaped 或不完整 delimiter 包围的 @2x	task 渲染与同步门禁	仅已匹配 code span 可跳过；其他明确 token 代码化/拒绝	字段和词法正反例通过	gap：PL-3
QS-OPERABILITY	HDR-1, AC-SYNC	current-only 下保持可诊断	operability	high	重新同步危险正文	当前路径	fail closed 并定位，不产生远端副作用	typed 位置 + 0 平台调用	covered

decision_id	selected_option	alternative_option	benefit	cost	assumption	rejection_reason	result_or_gap
D-CONTENT	生成规范表示 + 本地/同步门禁	远端 payload 改写	单一事实源	旧正文需修复	HDR-1 current-only	远端改写造成漂移	covered
D-LEXER	有限状态扫描	完整 AST	无新依赖、范围集中	必须精确定义安全跳过条件	危险模式有限	AST 过度扩张	gap：escaped/unclosed 分类需收紧
D-IDENTITY	明确 token 静态规则，不查用户 API	查询账号状态	确定且无网络依赖	不审计账号状态	HDR-2	存在性不能证明意图	covered

risk_id	decision_id	risk_or_sensitivity	affected_quality_attributes	tradeoff	mitigation_or_validation	result_or_gap
R-FIELD-COVERAGE	D-CONTENT	task 标题绕过格式化	correctness	覆盖字段增加少量测试	标题/描述/七类 input 矩阵	covered：PL-1 响应成立
R-STRUCTURE	D-LEXER	HTML/reference/delimiter 误判	precision	轻量扫描承担边界责任	状态机与结构矩阵	covered：PL-2 响应成立
R-TOKEN-ESCAPE	D-LEXER	非代码形式被误认为安全	precision, correctness	严格门禁会要求本地改成真正 code span	只跳过成功闭合的 code span；escaped/unclosed 继续扫描	gap：PL-3

decision_id	door_type	reversal_cost	migration_or_rollback	decision_status	result_or_gap
D-CONTENT	two-way	中	回退 helper/门禁，无数据逆迁移	resolved	covered
D-LEXER	two-way	低至中	集中收窄扫描条件并重同步源文件	resolved	gap：局部可逆，无需人工裁决
D-IDENTITY	two-way	低	未来另立只读审计	resolved	covered

evolution_id	scenario_type	source_id	confirmation_status	change_scenario	affected_scope	verification	result_or_gap
EV-CURRENT	evolution	HDR-1	confirmed	新生成/重新同步采用当前契约	lifecycle/comments	lifecycle/platform tests	covered
EV-MIGRATION	migration	HDR-1	not-applicable	不批量转换历史评论	历史远端数据	backfill 边界回归	not-applicable
EV-ROLLBACK	rollback	plan-r2.md:267	confirmed	回退重新暴露错误链接	helper/门禁	无 schema 逆迁移	covered
EV-COMPAT	compatibility	compatibility-policy	confirmed	无旧链接双写/读取	当前正文	grep 无 shim	covered
EV-OPS	operations	plan-r2.md:231-233	confirmed	旧危险正文得到定位错误	CLI/平台边界	line/column + 0 调用	covered

追踪矩阵

source_id	upstream	reviewed_target	verification	status_or_gap
AC-ARTIFACT	analysis-r2.md:47 artifact 引用代码化	plan-r2.md:116-124,161-165,243	helper/task-event tests	covered
AC-PATH	analysis-r2.md:48,85-86 拒绝本地目标并保留有效链接	plan-r2.md:99-114,155-170,245-249	策略/platform tests	covered
AC-MENTION	analysis-r2.md:49,87 明确 @2x 使用代码格式	plan-r2.md:46,75-76,90-99,122,155-159,241-246	task-create/content policy	gap：escaped/unclosed 非代码形式被保留
R-MARKDOWN	analysis-r2.md:88 保护 code/table/HTML/reference	plan-r2.md:78-83,101-114,155-159	状态机和结构矩阵	covered；PL-2 adjusted 可接受
HDR-1	task.md#HDR-1 current-only	plan-r2.md:50,56,63,131,248,264-265	compatibility-budget	covered
HDR-2	task.md#HDR-2 无用户查询	plan-r2.md:49,54,64,98,129,141,255,263	fake endpoint 记录	covered

问题清单

阻塞项（必须修复）

（无）

主要问题（建议修复）

PL-3：非代码的 escaped/unclosed @2x 被错误列为安全内容

文件：plan-r2.md:98-107

场景：正文包含 \@2x，或一个未闭合 backtick run 后出现 @2x。方案要求 formatter 保留前者，并要求 scanner 对两者都不报告。

影响：两种输入最终都没有形成代码 span，却可通过生成/同步门禁，违反已批准的“明确非用户 token 使用代码格式”要求。尤其未闭合 backtick 在 GFM 中只是普通字面字符，不是受保护代码语境；将其后续内容整体跳过还会同时隐藏危险链接。

证据：plan-r2.md:98,105,107,156,244,246 明确把这两类内容列为保持/跳过；analysis-r2.md:49 要求明确 token 使用代码格式。GitHub Flavored Markdown §6.1 示例 308 显示 \@ 渲染为普通 @，§6.3 示例 357-358 明确未匹配 backtick 只是 literal backticks。

置信度：high

未验证假设：未验证 GitHub 是否会对 escaped @2x 发送通知；该假设不影响 finding，因为验收要求是代码格式，而两种结果均非 code span。

修复方向：仅把成功匹配的 inline/fenced code 视为安全跳过区间。对 \@2x，formatter 应输出真正的 `@2x`，scanner 应把其视为未代码化 token；对未闭合 backtick，按 literal text 继续扫描其后的 token/link。补充四组 formatter/scanner 正反例与 line/column 断言。

次要问题（低影响但需闭环）

（无）

非阻塞建议

（无）

人工校验项

（无）

审查分歧账本回写

• PL-1：接受 adjusted 响应，调用 finding-review --status confirmed，证据指向 review-plan-r3.md#PL-1-response。
• PL-2：接受“有限状态机 + 结构矩阵”替代修法，调用 finding-review --status confirmed，证据指向 review-plan-r3.md#PL-2-response。
• 新 finding：PL-3，stage=plan，severity=major，evidence=review-plan-r3.md#PL-3。

PL-1-response

plan-r2.md:71-76,122,155-165,233,241 已把标题、描述、七类 task input 和原始 digest 边界纳入方案与验证，响应证据充分，原 finding 可确认关闭。

PL-2-response

plan-r2.md:78-83,101-114,155-170,239-255 已补齐 fence、inline code、HTML、reference、转义/delimiter 状态与结构测试矩阵；有限扫描器替代完整 AST 的方向可接受。PL-3 是修订契约中新出现的更窄安全分类错误，不否定 PL-2 的原始结构覆盖响应。

证据原文

• 断言：本轮输入为新的 plan-r2.md，输出身份为 review-plan-r3.md。

$ agent-infra-internal task-artifact TASK-20260826-184851 inspect --family review-plan
{"status":"ready","changed":false,"requestRef":"TASK-20260826-184851","taskId":"TASK-20260826-184851","taskDir":"/workspace/.agents/workspace/active/TASK-20260826-184851","taskState":"active","family":"review-plan","artifacts":[{"family":"review-plan","round":1,"name":"review-plan.md"},{"family":"review-plan","round":2,"name":"review-plan-r2.md"}],"latest":{"family":"review-plan","round":2,"name":"review-plan-r2.md"},"next":{"round":3,"name":"review-plan-r3.md"},"reviewedInput":{"family":"plan","round":1,"name":"plan.md"},"diagnostics":[],"error":null,"inputs":[{"family":"plan","round":2,"name":"plan-r2.md","path":"/workspace/.agents/workspace/active/TASK-20260826-184851/plan-r2.md","size":23244}],"codeMode":null}
$ sha256sum .agents/workspace/active/TASK-20260826-184851/plan-r2.md
e0bee301ebca4441acf63443a39ef674a739debf6a2789393669ae9ea1dd92db  .agents/workspace/active/TASK-20260826-184851/plan-r2.md

• 断言：PL-1、PL-2 响应已写入 ledger 并具有对称证据。

$ nl -ba .agents/workspace/active/TASK-20260826-184851/task.md | sed -n '134,139p'
   134	| id | stage | round | severity | status | evidence |
   135	|----|-------|-------|----------|--------|----------|
   136	| HD-1 | analysis | - | decision | human-decided | task.md#HDR-1 |
   137	| HD-2 | analysis | - | decision | human-decided | task.md#HDR-2 |
   138	| PL-1 | plan | 2 | major | adjusted | plan-r2.md#PL-1：已将 candidate.title 纳入受控生成字段，并补充标题 raw @2x 的 task-create 到 task-comment 正例；candidate digest 仍基于原始输入。 |
   139	| PL-2 | plan | 2 | major | adjusted | plan-r2.md#PL-2：已补充 fence、inline code、HTML、reference、转义语法和 delimiter 的最小状态机契约，并为危险目标与安全结构定义逐类正反例及 line/column 断言。 |

• 断言：方案把 escaped/unclosed 非代码文本列为安全跳过，而上游要求明确 token 使用代码格式。

$ nl -ba .agents/workspace/active/TASK-20260826-184851/plan-r2.md | sed -n '96,108p;153,159p;239,247p'
    96	新增无平台依赖的 `lib/task/issue-comment-content.ts`，供 task、artifact 和平台代码共同使用：
    97	
    98	- `formatKnownNonUserTokens(content)`：只在受控正文的代码围栏和行内代码之外，把明确的 raw `@2x` 包为 `` `@2x` ``；重复执行幂等。转义的 `\@2x`、`` `@2x` ``、`@alice`、邮箱和其他未知 `@` 文本保持原样，不访问网络。
    99	- `findIssueCommentViolations(content)`：返回结构化违规项，至少包含 `kind`、1-based `line`、1-based `column`、`token` 和 `message`。它只报告明确危险链接或未代码化的 raw `@2x`，不负责改写正文。
   100	
   101	#### 最小 Markdown 词法契约
   102	
   103	扫描器按以下顺序处理输入；未被识别为受控结构的普通字符保持原样：
   104	
   105	1. **转义字符**：反斜杠转义的 Markdown 标点（包括 `\[`, `\]`, `\(`, `\)`, ``\``` ``、`\@`）按普通文本跳过，不开启或关闭 link/code 状态；因此 `\@2x` 不报告违规。
   106	2. **fenced code**：行首允许最多三个空格；以三个或更多连续 backtick 或 tilde 开启围栏，记录字符类型和 delimiter 长度。只有同类型且长度不小于 opener 的行级 delimiter 才关闭围栏；围栏内全部内容（包括 HTML、reference 和 `@2x`）跳过。不同长度的 opener/closer 不得提前结束围栏。
   107	3. **inline code**：围栏外遇到未转义的 backtick run 时，寻找同长度的未转义 closing run；匹配区间内全部内容跳过。不同长度的 delimiter 不配对，未闭合 run按普通文本保留，不扫描其内部的 link 或 `@2x`。
   108	4. **HTML**：HTML comment `<!-- ... -->` 内不扫描 Markdown 语法；普通 HTML tag不把其中的方括号当 Markdown link，但检查 `href`/`src` 属性值，并对其目标使用同一危险目标分类器。
   153	按以下顺序实施，每步都保持可独立验证：
   154	
   155	1. **先写内容策略单元测试**
   156	   - 覆盖标题、描述和全部 task input 字段的 `@2x` 代码化、重复执行幂等、inline/fenced code 保护、真实 `@alice`/邮箱/转义 `\@2x` 保留。
   157	   - 覆盖不同长度 backtick/tilde fence 和 inline delimiter、HTML comment/tag、inline/reference/collapsed link、转义语法、表格和 receipt 的正反例。
   158	   - 覆盖 canonical artifact、workspace/用户目录/临时目录/Windows drive/UNC 目标的拒绝，以及外部 URL、Issue/PR/commit、anchor 和有效文档链接的保留。
   159	   - verify：策略测试能区分“需代码化”“需拒绝”“保持原样”三类结果；每个拒绝例断言 kind、line、column 和 token；不使用 GitHub 网络。
   239	| 输入 | 预期行为 | 验证位置 |
   240	|---|---|---|
   241	| 标题、描述或任一 task input 含 raw `@2x` | task-create 生成代码文本，候选 digest 不变 | content policy、task-create integration |
   242	| 手写 task/artifact 含 raw `@2x` | 完成事件或直接同步 fail closed，并给出位置 | artifact lifecycle、platform-comment tests |
   243	| 自动完成 `analysis.md` / `plan.md` / `code.md` 等产物 | task.md 写入描述加 `` `artifact.md` ``，不可点击 | `task-artifact-lifecycle.test.ts`、`task-event.test.ts` |
   244	| inline/fenced code、HTML comment、转义语法含危险样本文本 | 保持原样，不报告其中的 token/link | content policy tests |
   245	| HTML href、inline/reference link 含危险本地目标 | fail closed，报告 line/column，不产生平台调用 | content policy、platform-comment tests |
   246	| 正文含 `` `@2x` ``、`@alice`、邮箱、`\@2x` | 保持原样，不查询 GitHub 用户状态 | content policy、platform-comment tests |
   247	| 有效外链、Issue/PR/commit、anchor、正式文档相对链接 | 保持原语义 | content policy、platform-sync e2e |
$ nl -ba .agents/workspace/active/TASK-20260826-184851/analysis-r2.md | sed -n '47,50p'
    47	1. 生命周期自动追加到 `task.md` 的 artifact 引用不再生成 Markdown 相对链接，而使用不可点击的代码文本；普通生命周期完成事件和 PR review 完成路径都必须覆盖。
    48	2. 同步范围内的 artifact 正文不能以链接形式暴露 workspace 路径、用户目录、临时任务文件或其他明显只在本地有效的文件引用。正式项目文档及已经确认有效的仓库、Issue、PR、commit 和外部链接不属于泛化替换范围。
    49	3. 对明确的非用户语义 token（当前已确认示例为 `@2x`）使用代码格式，避免 GitHub 自动渲染为用户链接；看起来像账号但意图不明的提及保留原文，不根据账号当前是否存在来改写。
    50	4. 正常生成和同步流程不访问 GitHub 用户 API，不把网络、权限或限流状态引入正文生成主路径。

• 断言：GFM 将 escaped @ 渲染为普通字符，未匹配 backtick 也只是 literal text，不构成 code span。

$ curl -L --silent --show-error https://github.github.com/gfm/ | <extract GFM §6.1 and §6.3 examples>
6.1 Backslash escapes
Any ASCII punctuation character may be backslash-escaped:
Example 308
\!\"\#\$\%\&\'\(\)\*\+\,\-\.\/\:\;\<\=\>\?\@\[\\\]\^\_\`\{\|\}\~
<p>!"#$%&amp;'()*+,-./:;&lt;=&gt;?@[\]^_`{|}~</p>

When a backtick string is not closed by a matching backtick string,
we just have literal backticks:
Example 357
```foo``
<p>```foo``</p>
Example 358
`foo
<p>`foo</p>

自我质疑

• 未在真实 Issue 上验证 \@2x 是否触发用户通知；PL-3 不以通知副作用为前提，而以已批准的“必须是代码格式”和 GFM 解析结果为依据。
• 对 PL-2 的 adjusted 响应采用“确认原问题、另立更窄 finding”的处理，避免因一个新边界错误否定已经补齐的 HTML/reference/delimiter 架构契约。
• GFM 规范是 GitHub Markdown 的权威语法来源；GitHub 的 mention 扩展可能在其后增加行为，但不会把 escaped @ 或未闭合 backtick 变成 code span。

亮点

• PL-1 已用字段矩阵、端到端 task-comment 正例和原始 candidate digest 边界完整闭环。
• PL-2 已将原先模糊的轻量扫描器落成 fence、inline、HTML、reference、转义和目标分类契约，且没有引入完整 AST 或第三方依赖。
• current-only、单一正文事实源、无用户 API 和平台 I/O 前 fail-closed 边界继续保持一致。

与方案一致性

• PL-1 字段覆盖修订与已批准需求一致
• PL-2 结构扫描修订与已批准风险一致
• 所有明确 @2x 非代码形态均被代码化或拒绝
• 没有意外的范围扩张

结论与建议

审查决定

• 通过
• 需要修改
• 拒绝

下一步

聚焦修订 PL-3：只有成功闭合的 code span/fence 才能跳过扫描；escaped \@2x 和未闭合 backtick 后的明确 token 必须继续代码化或 fail closed。其余方案保持不变。

---

由 codex 自动生成 · 内部追踪：TASK-20260826-184851