验证记录

• 当前版本或分支: main @ 2697018
• 验证时间: 2026-10-26
• 复现命令: ls docs/ai-templates/；grep -rn "issue" docs/AI-TEMPLATES.md | head -5；ls .gitcode/
• 实际结果: docs/ai-templates/ 现有 10 个模板均为流程状态类（验证/进度/blocked/close/自检/评审结果等），无 issue 创建结构模板；.gitcode/ 下仅 workflows/，无平台级 ISSUE_TEMPLATE；issue 主张属实
• 预期结果: AI 协作者起草 issue 时有固化结构模板（四段结构 + 起草前查证清单 + 验收锚点），平台模板支持情况有实验结论
• 时间线检查: issue 于 2026-09-30 创建（基于 #611–#613 系列的经验沉淀），无关联 PR、无重复项；本会话随后以同结构创建 7 个 issue（GC_HOST 归因/确认组件/回归矩阵/token_valid/镜像契约/GitCode race/unshallow 共 7 项，编号 621–625、627、628），全部通过四角色评审管线进入流程——结构有效性又添 7 个样本
• 结论: 继续修复——按 issue 改动建议顺序执行：①先做平台验证实验（infra-test 仓试 .gitcode/ISSUE_TEMPLATE/，记录结论）；②新增 issue-create.md 模板；③注册 validate-ai-record.py 的 issue-create kind；④AI-TEMPLATES.md 补说明；⑤docs-governance 同步范围检查

平台验证实验记录（改动建议第 1 项）

• 实验设计: 向 infra-test/gctest1（main 分支）推送四个候选路径的探针模板（各自带可区分的实验名 front-matter）：.gitcode/ISSUE_TEMPLATE/、.gitea/ISSUE_TEMPLATE/、.github/ISSUE_TEMPLATE/、根目录 ISSUE_TEMPLATE/（探针提交 9754426、08dfd22）
• 验证方式: 人工打开 https://gitcode.com/infra-test/gctest1/issues/new 核验模板选择器（CLI 无法判定：创建页为登录态 JS 渲染，未认证 HTML 探针无信号；gc api repos/.../issue_templates 端点 404）
• 结论: GitCode 仅渲染 .github/ISSUE_TEMPLATE/ 约定——web UI 模板选择器仅显示"Bug 报告（实验-.github）"；.gitcode、.gitea、根目录 ISSUE_TEMPLATE 均不生效
• 推论: .github/ISSUE_TEMPLATE/ 同时是 GitHub 原生约定——主仓该目录经镜像同步后一个目录服务双平台 web UI
• 探针清理: 实验后已移除全部四目录（清理提交 066c2d9），测试仓恢复原状
• 落地: 主仓新增 .github/ISSUE_TEMPLATE/bug_report.md 与 feature_request.md（四段结构与 AI 侧 issue-create 模板对齐，面向人工 web UI 报告者）

实验记录补强（评审观察项）：

• 远端清理核验：infra-test/gctest1 远端 main HEAD 即清理提交 066c2d9，工作区四种 ISSUE_TEMPLATE 路径目录计数为 0（fetch + reset 到 origin/main 后实测）——探针清理有直接远端证据
• 四路可区分性：每个探针的 front-matter name 均带路径标识（"Bug 报告（实验-.gitcode）"等），web UI 选择器仅显示 .github 一项即四路结论的可审计依据

开发进度

• 当前状态: ready-for-review（PR !601 已完成自检、四角色独立评审四轮全部 approved、双端 CI 全绿，等待人工最终确认与合并）
• 根因: ai-templates 全为流程状态类、缺 issue 创建结构模板；四段结构经十个 issue 实践验证未固化；平台模板约定未经验证（详见验证记录与实验记录）
• 主要修改: 5 文件——issue-create.md 模板（四段 + 六项查证清单 + 占位符约定）、.github/ISSUE_TEMPLATE 双平台 web UI 模板、validate-ai-record.py（issue-create kind + 标题式字段解析 + 占位符执法）、AI-TEMPLATES.md、issue-workflow.md §1 spec 锚点
• 影响范围: 纯文档/模板/校验脚本；零生产代码
• 单元测试: go test ./... 163 包全通过；make validate-ai-templates 10 模板全过；record 执法三向验证（原样拒/混合拒/填充过）
• 构建: 无涉
• 实际命令验证: 平台实验（四路径探针 + 人工核验 + 清理 + 远端证据回填）；校验器构造性实验全链
• 安全影响: 平台模板含脱敏提示与私密渠道指引（安全评审 P2 修复）；无凭证变化
• 文档同步: AI-TEMPLATES + issue-workflow spec 锚点 + AGENTS 自动接线；全仓残留扫描闭环
• 风险或未覆盖项: risk/medium，合并前需人工最终确认；labels front-matter 自动打标留待首个使用场景；record 自动化覆盖登记 issue 629
• 关联 PR: !601

模板效果实测确认（PR !601 平台模板验收补强）

• 实测方式：将 !601 分支的正式模板（bug_report.md / feature_request.md 最终版，含脱敏提示与私密渠道指引）原样推上 infra-test/gctest1 main（预览提交 d4f4e22），人工在 web UI 创建页核验
• 结果：模板选择器正常显示「Bug 报告」与「功能建议」两项，模板渲染正常（平台实验结论在正式模板上复验成立）
• 清理：确认后已移除预览（清理提交 d972d19，.github 目录已不存在），测试仓恢复原状
• 未实验项维持：front-matter labels（type/bug 等）的自动打标行为仍待首个真实使用场景验证（需实际创建 issue）——已记录于 PR !601 自检未覆盖项