关于 add-stack-context
add-stack-context 用于发现并安装项目所用技术的官方厂商上下文。它核实归属和安装方式,将持续变化的厂商文档设为 Agent 指令中的实时参考,并逐项记录处理结果。
主要功能
- 01盘点项目声明的技术
- 02查找相关技能和厂商上下文
- 03核实官方归属与安装步骤
- 04在 Agent 指令中加入实时厂商指南
- 05跟踪每项技术的处理结果
适用场景
- 01为陌生代码库准备 Agent 工作环境
- 02查找项目依赖的官方指南
- 03在任务期间保持厂商文档更新
- 04报告缺失或受阻的技术上下文
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ toy-crane/ skills --skill add-stack-context安装后在 Claude Code 中输入/add-stack-context确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlevals/evals.jsontrigger-evals.json详细介绍
添加技术栈上下文
清点技术栈
根据清单文件和配置文件,列出直接影响项目构建或运行的技术,作为检查清单。包括框架、库、开发者工具和托管服务;排除传递依赖。使用锁定文件确认已安装的版本,不要据此扩充检查清单。如果项目尚未声明技术栈,请询问用户打算使用什么技术。
查找技能和供应商上下文
对于检查清单中的每一项,如果有 find-skills,就调用它来查找相关技能。如果没有,则通过 Skills CLI 或其他当前来源搜索当前 Skills 生态,以确保此技能可独立安装。
根据技术供应商的当前文档或官方组织核实候选项的归属。搜索排名、安装数量和代码仓库人气都不能证明其归属关系。检查文档中说明的安装方法和预期变更;如果缺少由供应商控制的技能,则安装该技能。将相关的社区技能作为可选候选项进行评估,但只有在用户明确批准后才安装,且绝不能将其视为该技术的官方上下文。
继续查阅供应商的当前来源,获取技能搜索未涵盖的官方上下文,包括安装程序、codemod、软件包附带的文档和 MCP 服务。如果供应商提供特定版本的上下文,则匹配已安装版本,并采用供应商文档中说明的方法。如果没有官方渠道,则记录这一缺口,不能用社区候选项替代官方上下文。
保持不断变化的指南为最新版本
将供应商的 llms.txt 或同等的动态文档视为当前远程来源,而不是复制到仓库中的文件。在仓库现有的 AGENTS.md 或 CLAUDE.md 中添加或更新范围明确、由供应商管理的指令。注明技术名称和官方来源,要求后续 Agent 在开始相关工作时获取该文档,并要求其与已安装版本进行核对。
保留用户编写的上下文以及现有的链接、导入或其他指令文件之间的共享方式。如果两个文件互相独立且均在使用,则在两者中都提供相同的实时获取行为,同时不替换其余内容。将由供应商管理的代码块视为供应商所有,只能通过官方方法更新。
确保涵盖所有技术
只有在检查清单中的每一项都符合以下四种结果之一时,才算完成:
- 已安装;
- 已存在;
- 官方来源不可用;或
- 受阻,并注明原因。
总结每项技术的结果以及已核查的官方来源。对于已安装的上下文,注明所做的变更和供应商文档中说明的更新途径。单独列出等待批准的社区候选项。对于供应商的实时指南,将任务开始时获取指南注明为更新途径;如果获取受阻,应报告这一情况,而不能将缓存副本视为当前版本。