用途:刷新编码代理上下文文件(如 CLAUDE.md、.github/copilot-instructions.md、AGENTS.md)中由 Spec Kit 管理的区块,使代理指令与最新的计划文档保持一致。
主要能力:脚本读取 .specify/extensions/agent-context/agent-context-config.yml,发现 context_file(要管理的上下文文件路径)以及 context_markers.start / .end(管理区块的起止分隔符,字段缺失时默认使用 <!-- SPECKIT START --> 与 <!-- SPECKIT END -->)。随后创建、替换或追加管理区块,使其指向最新可发现的计划路径 specs/<feature>/plan.md。
使用方式:Bash 运行 .specify/extensions/agent-context/scripts/bash/update-agent-context.sh [plan_path];PowerShell 运行 .specify/extensions/agent-context/scripts/powershell/update-agent-context.ps1 [plan_path]。省略 plan_path 时自动检测最近修改的 specs/*/plan.md。
适用场景:在 Spec Kit 项目中维护多个编码代理的上下文/指令文件,需要让这些文件持续引用最新特性计划时使用。
限制:当 context_file 为空或文件无法定位时,命令报告无需操作并以成功状态退出;其余行为依赖配置文件中的路径与标记设置。