已合并
docs: sediment the issue-create template and platform web-UI templates #601
aflyingto创建于 10 天前
docs: sediment the issue-create template and platform web-UI templates #601
已合并
Pull Request已成功合入, 合并人@aflyingto
（感谢 aflyingto 的贡献）此处折叠了13条事件消息 查看更多
aflyingto
10 天前 评论：
10 天前 评论：
多角色独立执行主体评审汇总
评审主体
- 作者主体: Claude Code 主会话（aflyingto 账号操作）
- 评审主体: 四个独立评审 Agent（review-code / review-security / review-test / review-docs），与作者互为不同执行主体，均基于分支 diff、校验器构造性实验、七样例 issue 对照与端到端起草实验独立验证
评审轮次与结论
| 评审角色 | 首轮（fa5638a） | 安全修复（fb255fa） | 综合修复（bf65a93） | 最终微修（fb27983） |
|---|---|---|---|---|
| 代码审查 | approved（1 P2 占位符旁路【实测】+ 2 P3） | —（顺带核验通过） | approved（2 新 P3 残差） | approved（0 发现；三向独立复验） |
| 安全审查 | needs-improvement（1 P2 平台模板脱敏/私密渠道） | approved（0 发现） | approved（0 发现；边缘告知） | approved（亲测五段判空） |
| 测试审查 | approved（1 P3 record 覆盖 + 2 观察） | — | needs-improvement（1 P3 证据占位残留，含自正） | approved（三向独立复现含其 finding 精确场景） |
| 文档审查 | approved（1 P2 spec 锚点 + 开放点肯定判定） | — | approved（0 发现；边缘告知） | approved（独立构造混合草稿实测） |
发现问题与修复情况
- 首轮 4 项发现全部落地：占位符旁路（代码 P2，实测证明原样模板曾通过 record——修复后与其他 10 kind 出厂行为对齐）、平台模板脱敏提示与私密渠道（安全 P2，fb255fa）、查证清单第 3 项 merged PR/origin/main 口径（代码 P3）、spec 锚点 issue-workflow §1 模板指针（文档 P2）
- 增量轮 2 项：证据段列表形态占位的混合草稿旁路（安全/代码/文档三方独立收敛，fb27983 闭合并三向验证）、相对链接表单渲染 404 陷阱（fb27983 转纯文本）
- 记录修正：模板计数 11→10、AI-TEMPLATES 日期戳、远端探针清理证据回填
- 后续登记：record 模式自动化覆盖（issue 629，含列表形态占位与混合草稿负例的定型语义）
评审亮点（分层评审价值实证）
- 占位符旁路由代码审查构造性对照实验发现（列表式原样必挂 vs 新 kind 原样通过），安全与文档在增量轮独立收敛同一残留边缘——三方从不同角度钉住同一缺口
- 测试审查以四分支变体独立复现校验器语义并完成端到端起草实验；文档审查以七样例 issue 对照证实模板"如实沉淀实践"
总体评审结论
四角色全部 approved（最终状态零未决发现）。 风险分级 risk/medium（模板 + 校验脚本），按规范需人工最终确认后方可合并。占位符执法终态：原样模板必拒（五节全判空）、混合草稿（任一节留占位）必拒、真实填充通过——与全部既有 kind 的出厂行为对齐。
变更内容
issue 创建模板沉淀（issue 614，五个子项全落地）：
.github/ISSUE_TEMPLATE/（.gitcode/.gitea/根目录均不生效）；探针已清理。该路径同时是 GitHub 原生约定，主仓一个目录服务双平台 web UI.github/ISSUE_TEMPLATE/（生效落地）：bug_report.md + feature_request.md，四段结构与 AI 侧模板对齐、面向人工报告者，front-matter name/about/labelsdocs/ai-templates/issue-create.md：四段结构骨架 + 起草前查证清单（HTML 注释形态：spec 无覆盖/file:line 证据/查重/标签/契约不破坏/脱敏六项）+ 验收锚点指引scripts/validate-ai-record.py：注册 issue-create kind；解析器扩展支持标题式字段（章节模板）与既有列表式字段并存，record 模式做章节内容非空检查（双向验证：齐全通过/掏空章节被抓）docs/AI-TEMPLATES.md：使用节（含 validate-then-create 命令链）作者自检
.github/ISSUE_TEMPLATE/新目录随镜像同步自动服务 GitHub web UIgo test ./...163 包全部通过（校验脚本为 Python，不在 go test 范围）；make validate-ai-templates全部 10 个模板通过（含新 kind）；record 模式占位符执法对齐（原样模板被拒、填写样例通过——与其他 10 个 kind 的出厂行为一致）Closes #614
🤖 Generated with Claude Code