ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

GSD Core 1.15.0 版本解析:bracket 阶段 ID 迁移、compact-content 上下文压缩与规划文档统一写路径

GSD Core 1.15.0 版本解析:bracket 阶段 ID 迁移、compact-content 上下文压缩与规划文档统一写路径 【免费下载链接】gsd-coreGit. Ship. Done - Core项目地址https://gitcode.com/gh_mirrors/ge/gsd-core点击查看免费下载GSD CoreGit. Ship. Done在 2026-09-26 发布的 1.15.0 版本中围绕「阶段标识符规范化」「规划文档写入统一」和「Agent 上下文瘦身」三大主题完成了一系列底层重构与行为修正。本文以该版本的官方变更记录CHANGELOG.md为骨架结合仓库源码与 ADR 文档系统梳理新版本的关键变化、配置入口与升级注意事项帮助你判断是否需要迁移到 bracket 阶段 ID、理解 compact-content 的收益边界以及规避升级时可能触发的行为变化。版本背景与总体定位GSD Core 是面向 AI Agent 的阶段性软件交付框架围绕「讨论 → 规划 → 执行 → 验证 → 发布」的五步闭环组织工作。1.15.0 处于 1.14.02026-09-14与下一里程碑之间变更记录遵循 Keep a Changelog 规范分为 Added / Changed / Removed / Fixed / Security 五类。这一版本没有引入新的运行时而是集中解决历史积累的一致性问题阶段 ID 语法在多处解析器之间不一致、规划文档被各命令用自研正则改写、上下文预算机制在部分工作流中空转等。Added新能力与迁移工具1. bracket 阶段 ID 约定全面落地read path 迁移器这是 1.15.0 最核心的语法层变化。ADR-612 定义的 bracket 语法把「里程碑milestone」从阶段 token 中整体剥离用方括号表达[GSD.02] 05.03-01 │ │ │ │ └── plan 01 仅出现在文件名表面唯一连字符 │ │ │ └────── subphase 03 可选的点分分解 │ │ └───────── phase 05 零填充整数 │ └───────────── milestone 02 点分并入方括号本版本的三件事进度面统一渲染progress、stats、manager init 与两种 statusline 格式仅在phase_id_convention恰好等于bracket时才渲染[CODE.MM] NN形式其他约定保持原有输出形状。config-set现在会校验该配置的三个合法值。roadmap upgrade --convention bracket迁移器默认 dry-run 预览需要项目代码project code重写 ROADMAP 中匹配的标题与复选框重命名阶段目录及其内部的阶段限定产物重写命名了被改名兄弟阶段的depends_on与phase:frontmatter仅在 apply 时写入phase_id_convention: bracket拒绝脏工作树apply 失败时对外部管理的.planning/字节做外科式恢复。注意迁移器默认是预览模式真正落地必须显式--apply且要求工作树干净。规划文档统一读写 seam新增内部PlanningDoc层组合既有 markdown-sectionizer、markdown-table 与 frontmatter 三套 seam使任何 verb 都不能再对.planning/产物自带正则。字段写入只触及自己的值 token同行手写散文保持原样序列化拼接进原始 buffer未触及区域字节不变文档内含解析器读不出的区域时直接拒绝写入。这一阶段只建 seam不改任何命令行为。从源码看bracket 语法落在 src/phase-id.cts 这个单一权威 owner 内迁移器位于 src/roadmap-upgrade.cts规范定义见 docs/adr/612-bracket-phase-id-convention.md。适用前提未 opt-in 的项目默认phase_id_convention: null行为完全不变bracket目前是 read path 的 opt-in迁移器是 write path 的入口合法取值记录在 docs/CONFIGURATION.md。2./gsd-ui-review支持采集交互后 UI 状态新增默认关闭的workflow.ui_interaction_capture配置键挂在uicapability 上让gsd-ui-auditor能通过chrome-devtoolsCLI 采集 hover、focus-ring、打开菜单、填表状态等截图纯 Bash 驱动、无需 MCP server、不改工具面。要求本机安装 Chrome关闭或解析不到时退回到与原来完全一致的 Playwright-only 静态采集。3. 知识图谱查询接入graphifyCLIplanner 与 phase researcher 在PATH上存在graphify时改用它查询知识图谱否则回退内置 reader。两个 Agent 本来就持有Bash因此不需要新配置键、也不需要新的工具授权。gsd-tools graphify status现在返回graph_path解析后的绝对图谱路径。已知限制两条路径返回形状不同CLI 是散文、内置 reader 是带置信度层的 JSON--budget在一侧按渲染输出计数、在另一侧按估算字节计数两条提示词都如实声明而非假装稳定。Changed行为收紧与配置语义变化1.checkpoint:decision自动选择改为 opt-inauto 模式下没有auto_selectoption-id属性的决策 checkpoint 现在升级给人类处理不再静默选中第一个option。要让计划完全无人值守必须显式auto_select指定目标选项的id若auto_select指向不存在的选项 id会在verify plan-structure解析阶段直接失败。2. 代码审查门禁记录每条发现的处置/gsd-execute-phase的代码审查门禁现在输出严重度分布如23 findings — 1 critical, 9 warning, 8 info接受blocker:作为critical:的文档等价物并在审查旁写入NN-REVIEW-DISPOSITION.md台账每条发现默认open保留人类记录的处置即使后续审查不再报告该发现也继续携带该行。/gsd-code-review N --fix会把这些记录的fixed/skipped回写进同一台账。门禁始终是 advisory从不阻断。3.gsd install//gsd-update校验运行时可执行入口钩子脚本或其解释器缺失、不可读、不可执行时安装现在直接失败并点名违规路径不再打印Done!掩盖一个钩子永远不会触发的配置。4. stall 检测可显式关闭planner.stall_detection_enabled设为false即可使用运行时原生的完成等待不依赖 watchdog 轮询。默认仍为开启关闭意味着放弃有界的自动恢复能力。5./gsd-autonomous --converge可覆盖配置门禁显式传--converge或--cross-ai时即使workflow.plan_review_convergence为false也启用该次运行的规划评审收敛不再以「请先开启配置」提示中止。不带该 flag 时行为与原来一致独立运行的/gsd-plan-review-convergence仍受配置门禁约束。6. loop-host Agent 角色家族约束五个 loop 步骤各有其角色家族orchestration / planning / execution。工作流现在不能把orchestrator声明进 execute 步骤的agent-roles也不能声明词汇表外的角色或未知步骤契约生成器会逐个列出全部违规者而非只报第一个。已发布的 workflow 与 capability 无需改动。Removed退役的 Gemini CLI 审查通道Google 于 2026-06-18 停止为 Gemini CLI 的免费/Pro/Ultra 提供服务因此/gsd-review --gemini拉起的二进制对多数用户已不再响应。本版本移除--geminiflag、三个review.*.gemini配置键及五个语言版本的文档Antigravity 的--agy通道已覆盖 Google 位。gsd config-set review.models.gemini现在报 unknown key.planning/config.json中残留的旧键仍能解析只是永远不会被读取。Fixed一批跨子系统的确定性修复1.15.0 的 Fixed 部分规模很大以下按主题归纳并标注源码/测试位置主题修复内容威胁 ID--gaps重规划不再复用本相位内早期计划已分配的T-{phase}-NN编号execute-phase 在分发任何执行器前硬停planner 被指示继续从本相位已用最高编号之后编号verify.artifacts路径是目录时不再让整次检查以 EISDIR 崩溃改为单条失败并继续检查其余产物提交验证修复 macOS 上超大commit_types列表导致正则编译失败、误拒合法 Conventional Commit 的问题Linuxglibc无此限制两条路径都补了回归测试验证指纹covered_digestv2 不再把仓库级规划文档.planning/ROADMAP.md、REQUIREMENTS.md计入指纹避免完成任一相位就把所有验证标记为 stale旧 v1 指纹语义保留到重新指纹化verify-work用执行器记录的plan_head_after做有界窗口精确比对不再把诚实计划误报为commit_claim_mismatchTDD 红证接受 Surefire/Failsafe XMLJVM 项目按 tag 边界扫描分类*.test.*/*.spec.*/tests/之外新增 Go、Ruby、Elixir、Python 的命名惯例识别字母变体相位 ID/gsd-code-review、gsd-code-fixer、/gsd-execute-plan、/gsd-plan-phase等六个站点与七个 shell 站点统一接受12A、3A、23A.1.2语法对齐 src/phase-id.cts并加 ratchet 防再发散运行时解析运行时检测不再把退役的 gemini 解析为 Claude Code模型覆盖与dynamic_routing.tier_models现在作用于实际 spawn 的 AgentWindows CI测试分块预算由「按文件数比例」改为「按实测耗时」未测文件按 Windows 约 2.2x 成本地板计重最重的测试文件获得独立分块安全导出的CONFIG_STATUS/CMD_STATUS/CLASSIFY_STATUS不再能关闭提交消息门禁状态变量现在写入前初始化升级注意事项行为变化速查以下变化在升级后可能首次运行即可感知建议逐条核对决策 checkpoint 默认升级给人类如果全自动计划依赖「静默选第一个选项」需要给决策加auto_selectid。/gsd-execute-phase代码审查现在会产生NN-REVIEW-DISPOSITION.md台账文件并报告严重度分布此前对info与 Critical 输出相同字节消息的行为已改变。安装/更新失败更严格钩子不可执行时安装直接失败不会伪报成功。配置键校验变严config-set review.models.gemini报 unknown keyconfig-set校验phase_id_convention三个合法值。TDD 红证接受面扩大Go/Ruby/Elixir/Python 项目提交行为性任务不再误触TDD GATE TRIPPEDRust 仍是有文档说明的缺口#[test]在实现文件内路径门禁不可见。知识图谱注入内容可能变化graphify在 PATH 上时 planner/researcher 用 CLI 查询语义seed 排名、两跳扩展、--budget剪枝与内置 reader 不同但graphify缺席时注入上下文与升级前字节一致。参考文档与源码索引版本记录CHANGELOG.md本文章的数据来源bracket 约定规范docs/adr/612-bracket-phase-id-convention.md阶段 ID 语法权威实现src/phase-id.cts迁移器实现src/roadmap-upgrade.cts规划文档统一写路径src/planning-document.ctscompact-content 门禁后续版本引用gsd-core/references/compact-content-gate.md配置参考docs/CONFIGURATION.md说明以上所有行为描述均以本仓库当前 CHANGELOG.md 及所列源码/ADR 为依据版本号、日期与命令行为以仓库实际内容为准。若你的项目已使用.planning/config.json携带dynamic_routing.tier_models或model_profile_overrides等此前失效的配置升级后它们将首次生效请先复核再升级。赞分享【免费下载链接】gsd-coreGit. Ship. Done - Core项目地址https://gitcode.com/gh_mirrors/ge/gsd-core点击查看免费下载相关推荐gsd-core 中 bracket 阶段 ID 约定的统一显示与配置校验解析gsd core 中 bracket 阶段 ID 约定的统一显示与配置校验解析 本文围绕 gsd core 的 ADR 612「bracket 阶段 ID 约定GSD Core v1.40.0 文档审计解读Skill 面整合、namespace 两阶段路由与上下文窗口守卫GSD Core v1.40.0 文档审计解读Skill 面整合、namespace 两阶段路由与上下文窗口守卫 本文聚焦 GSD Core 仓库中 v1.4gsd-core Progress 路由的规划前假设检查统一规范化 /gsd-discuss-phase 替代路径gsd core Progress 路由的规划前假设检查统一规范化 /gsd discuss phase 替代路径 导读 本篇文章以 gsd core 仓库上一篇Windows 10 BloatRemover 深度解析命令行驱动的系统优化完整指南下一篇3分钟永久激活Windows和OfficeKMS_VL_ALL_AIO智能脚本终极指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表