{
  "schemaVersion": "bitshovel-editorial-review-v1",
  "id": "reader-service-attention-clarity-2-20260906",
  "signalId": "github-weekly-go-modern-guidelines",
  "originalUrl": "https://github.com/JetBrains/go-modern-guidelines",
  "kind": "editorial-correction",
  "reviewedAt": "2026-09-06T03:59:49.158Z",
  "before": {
    "id": "github-weekly-go-modern-guidelines",
    "banner": {
      "url": "/card-art/github-weekly-go-modern-guidelines-official.png",
      "credit": "GitHub OpenGraph 卡片 · JetBrains/go-modern-guidelines",
      "license": "© JetBrains/go-modern-guidelines · GitHub OpenGraph, embed intended"
    },
    "state": "new",
    "lane": "openSourceGrowth",
    "publishedAt": null,
    "observedAt": "2026-09-03T22:03:06.491Z",
    "originalUrl": "https://github.com/JetBrains/go-modern-guidelines",
    "relatedSources": [
      {
        "label": {
          "zh": "GitHub 本周 Trending",
          "en": "GitHub weekly Trending"
        },
        "url": "https://github.com/trending?since=weekly"
      }
    ],
    "source": {
      "zh": "GitHub 周榜、官方 API 与 README",
      "en": "GitHub weekly chart, official API, and README"
    },
    "title": {
      "zh": "让编码助手按项目版本写 Go",
      "en": "Help coding agents write Go for your project version"
    },
    "summary": {
      "zh": "JetBrains 的指南让编码助手先读取 go.mod，再选择该版本支持的语言和标准库写法，减少生成过时写法或使用过新特性的机会。",
      "en": "JetBrains’ guidelines tell coding agents to read go.mod before choosing language and standard-library features. They aim to avoid outdated patterns and code that requires a newer Go version than the project uses."
    },
    "why": {
      "zh": "如果你用 AI 维护 Go 项目，可以在常见重构中检查它是否减少了版本不兼容的建议。已有项目的目标版本应决定可用写法，而不是跟着工具示例盲目升级。",
      "en": "If you maintain Go projects with AI, test the guidance on common refactors and look for fewer incompatible suggestions. The project’s target version should determine which features are used."
    },
    "caveat": {
      "zh": "指南不能保证助手遵守，也不替代编译、静态分析与测试。安装工具自身需要的 Go 版本，与它应遵循的项目目标版本是两回事；本站未实测效果。 周榜与 Star 只反映关注度，不能证明采用或效果。",
      "en": "The guidelines do not guarantee agent compliance or replace compilation, static analysis and tests. The installer’s Go requirement is separate from the project version it should respect. We have not tested the results. Weekly rank and stars reflect attention, not adoption or results."
    },
    "timeline": [
      {
        "date": {
          "zh": "2026-09-04 周榜",
          "en": "2026-09-04 weekly chart"
        },
        "datetime": "2026-09-03T22:00:28.005Z",
        "summary": {
          "zh": "GitHub 本周 Trending 位列第 4，本周增加 1,403 Star。",
          "en": "GitHub weekly Trending ranked #4, recording 1,403 stars for the week."
        },
        "source": {
          "zh": "GitHub 本周 Trending 快照",
          "en": "GitHub weekly Trending snapshot"
        }
      }
    ],
    "followTarget": {
      "id": "repository:jetbrains/go-modern-guidelines",
      "label": {
        "zh": "go-modern-guidelines",
        "en": "go-modern-guidelines"
      },
      "scope": {
        "zh": "仓库与公开发布状态",
        "en": "Repository and public release state"
      },
      "url": "https://github.com/JetBrains/go-modern-guidelines",
      "updateMode": "editorial-watch"
    },
    "ingestion": {
      "mode": "editorial",
      "adapter": "github-trending-auto",
      "evidenceClass": "attention-signal",
      "editorialReadiness": "decision-brief"
    },
    "editorialReview": {
      "id": "reader-service-attention-boundary-2-20260906",
      "reviewedAt": "2026-09-06T03:53:02.019Z",
      "kind": "editorial-correction",
      "note": {
        "zh": "补充说明用于发现项目的周榜与 Star 只反映关注度；功能描述依据官方文档，使用效果仍需验证。",
        "en": "Clarified that weekly rank and stars indicate attention. Capability descriptions rely on official documentation; outcomes still require testing."
      },
      "sources": [
        {
          "label": {
            "zh": "JetBrains/go-modern-guidelines · README.md（核验版本）",
            "en": "JetBrains/go-modern-guidelines · README.md (reviewed revision)"
          },
          "url": "https://github.com/JetBrains/go-modern-guidelines/blob/91a30b36f05bb6424bd77e9817811c0e9c003aa2/README.md"
        },
        {
          "label": {
            "zh": "JetBrains/go-modern-guidelines：当次 GitHub 周榜记录",
            "en": "JetBrains/go-modern-guidelines: retained GitHub weekly chart observation"
          },
          "url": "https://github.com/trending?since=weekly"
        }
      ],
      "sourceAssessments": [
        {
          "url": "https://github.com/JetBrains/go-modern-guidelines/blob/91a30b36f05bb6424bd77e9817811c0e9c003aa2/README.md",
          "role": "direct-support",
          "scope": {
            "zh": "要求智能体读取 go.mod，并只使用项目版本支持的语言和标准库特性。",
            "en": "Directs agents to read go.mod and use language and standard-library features supported by the project version."
          },
          "limitations": {
            "zh": "属于生成代码的指导规则，不保证智能体遵守；接入 CLI 的工具链要求另行适用。",
            "en": "These are instructions, not guaranteed agent compliance. The integration CLI has a separate toolchain requirement."
          },
          "evidenceUrls": [
            "https://github.com/JetBrains/go-modern-guidelines/blob/91a30b36f05bb6424bd77e9817811c0e9c003aa2/README.md"
          ]
        },
        {
          "url": "https://github.com/trending?since=weekly",
          "role": "background",
          "scope": {
            "zh": "提供该项目在当次 GitHub 周榜的发现与关注记录。",
            "en": "Provides the project’s discovery and attention record from that GitHub weekly chart observation."
          },
          "limitations": {
            "zh": "只说明历史观察时点的榜位和 Star；不证明功能、采用情况或今天的排名。",
            "en": "Shows rank and Star counts at the historical observation only; it does not establish capabilities, adoption, or today’s position."
          },
          "evidenceUrls": [
            "https://github.com/trending?since=weekly"
          ]
        },
        {
          "url": "https://github.com/JetBrains/go-modern-guidelines",
          "role": "direct-support",
          "scope": {
            "zh": "阅读当前 JetBrains 仓库 README，核对读取 go.mod、按版本选择语言/标准库建议、安装说明与工具运行要求；现有固定版本文档证据需保留。",
            "en": "Read the current JetBrains README for go.mod-based guidance, version-specific language and library recommendations, installation and runtime requirements. Retain the existing pinned document evidence."
          },
          "limitations": {
            "zh": "核验的是指南规定的行为，未证明任何编码模型一定遵守，也未开展代码质量比较。",
            "en": "Verified the prescribed behavior, not compliance by any coding model or a comparative code-quality result."
          },
          "evidenceUrls": [
            "https://github.com/JetBrains/go-modern-guidelines/blob/91a30b36f05bb6424bd77e9817811c0e9c003aa2/README.md"
          ]
        }
      ],
      "previousReview": {
        "id": "reader-service-5-20260906",
        "reviewedAt": "2026-09-06T03:48:28.209Z",
        "kind": "evidence-review"
      }
    },
    "digest": {
      "zh": "先认清项目的 Go 版本，再给编码助手相应的写法约束。",
      "en": "Read the project’s Go version first, then give the coding agent matching guidance."
    }
  },
  "after": {
    "caveat": {
      "zh": "指南不能保证助手遵守，也不替代编译、静态分析与测试。安装工具自身需要的 Go 版本，与它应遵循的项目目标版本是两回事；本站未实测效果。 周榜与 Star 只反映关注度，不能证明采用或效果。",
      "en": "The guidelines do not guarantee agent compliance or replace compilation, static analysis and tests. The installer’s Go requirement is separate from the project version it should respect. We have not tested the results. Star counts and weekly rank reflect attention, not adoption or results."
    }
  },
  "withdrawnSources": [],
  "withdrawnTimeline": [],
  "evidence": [
    {
      "label": {
        "zh": "JetBrains/go-modern-guidelines · README.md（核验版本）",
        "en": "JetBrains/go-modern-guidelines · README.md (reviewed revision)"
      },
      "url": "https://github.com/JetBrains/go-modern-guidelines/blob/91a30b36f05bb6424bd77e9817811c0e9c003aa2/README.md",
      "rawUrl": "https://raw.githubusercontent.com/JetBrains/go-modern-guidelines/91a30b36f05bb6424bd77e9817811c0e9c003aa2/README.md",
      "revision": "91a30b36f05bb6424bd77e9817811c0e9c003aa2",
      "path": "app/_content/editorial-reviews/evidence/go-guidelines-readme.md",
      "sha256": "20eacd817e9e34f858451219d17d09e17e75866097c83e83f3604a1e5c3a504e",
      "bytes": 7336,
      "fetchedAt": "2026-09-05T06:44:16.282Z"
    },
    {
      "type": "retained-trending-entry",
      "label": {
        "zh": "JetBrains/go-modern-guidelines：当次 GitHub 周榜记录",
        "en": "JetBrains/go-modern-guidelines: retained GitHub weekly chart observation"
      },
      "url": "https://github.com/trending?since=weekly",
      "path": "app/_content/editorial-reviews/evidence/r127-go-guidelines-trending-entry.json",
      "sha256": "7b52d6ec238f37b77419f929602f3897fac4845505d3562db59a01446831a370",
      "bytes": 728,
      "fetchedAt": "2026-09-03T22:05:26.195Z",
      "retainedRecord": {
        "sourceSnapshot": "app/_content/source-observations/history/github-trending-weekly.2026-09-03T22-05-26-195Z.snapshot.json",
        "sourceSnapshotSha256": "c8665700e48302ea185390806aab07a92c58c1be737f6c87b5d763dfc0bf04c1",
        "observedAt": "2026-09-03T22:05:26.195Z",
        "sourceKey": "github-trending:jetbrains/go-modern-guidelines",
        "item": {
          "sourceKey": "github-trending:jetbrains/go-modern-guidelines",
          "rank": 4,
          "repository": "JetBrains/go-modern-guidelines",
          "originalUrl": "https://github.com/JetBrains/go-modern-guidelines",
          "description": "Help AI coding agents write modern Go",
          "language": "Go",
          "metrics": {
            "stars": 3104,
            "forks": 86,
            "starsThisWeek": 1403
          }
        }
      }
    }
  ],
  "sourceAssessments": [
    {
      "url": "https://github.com/JetBrains/go-modern-guidelines/blob/91a30b36f05bb6424bd77e9817811c0e9c003aa2/README.md",
      "role": "direct-support",
      "scope": {
        "zh": "要求智能体读取 go.mod，并只使用项目版本支持的语言和标准库特性。",
        "en": "Directs agents to read go.mod and use language and standard-library features supported by the project version."
      },
      "limitations": {
        "zh": "属于生成代码的指导规则，不保证智能体遵守；接入 CLI 的工具链要求另行适用。",
        "en": "These are instructions, not guaranteed agent compliance. The integration CLI has a separate toolchain requirement."
      },
      "evidenceUrls": [
        "https://github.com/JetBrains/go-modern-guidelines/blob/91a30b36f05bb6424bd77e9817811c0e9c003aa2/README.md"
      ]
    },
    {
      "url": "https://github.com/trending?since=weekly",
      "role": "background",
      "scope": {
        "zh": "提供该项目在当次 GitHub 周榜的发现与关注记录。",
        "en": "Provides the project’s discovery and attention record from that GitHub weekly chart observation."
      },
      "limitations": {
        "zh": "只说明历史观察时点的榜位和 Star；不证明功能、采用情况或今天的排名。",
        "en": "Shows rank and Star counts at the historical observation only; it does not establish capabilities, adoption, or today’s position."
      },
      "evidenceUrls": [
        "https://github.com/trending?since=weekly"
      ]
    },
    {
      "url": "https://github.com/JetBrains/go-modern-guidelines",
      "role": "direct-support",
      "scope": {
        "zh": "阅读当前 JetBrains 仓库 README，核对读取 go.mod、按版本选择语言/标准库建议、安装说明与工具运行要求；现有固定版本文档证据需保留。",
        "en": "Read the current JetBrains README for go.mod-based guidance, version-specific language and library recommendations, installation and runtime requirements. Retain the existing pinned document evidence."
      },
      "limitations": {
        "zh": "核验的是指南规定的行为，未证明任何编码模型一定遵守，也未开展代码质量比较。",
        "en": "Verified the prescribed behavior, not compliance by any coding model or a comparative code-quality result."
      },
      "evidenceUrls": [
        "https://github.com/JetBrains/go-modern-guidelines/blob/91a30b36f05bb6424bd77e9817811c0e9c003aa2/README.md"
      ]
    }
  ],
  "note": {
    "zh": "明确区分 Star 关注度与真实采用、使用效果。",
    "en": "Clarify the distinction between Star counts and actual adoption or outcomes."
  },
  "integrity": "a5b510109a902b91139e99acd17850b2e48ba064fc618f0c1b33145325cad321"
}