用途
update-tech-stack 用于更新项目中的技术栈文档（Tech Stack Documentation），使其反映当前的技术状态、依赖变更、新工具采用以及基础设施演进。目标文档位于 .claude/rules/2-tech-stack.mdc，技能会读取现有文档、分析变化并增量更新，同时保持技术准确性。
主要能力
- 文档分析：完整读取现有
2-tech-stack.mdc，记录已文档化的版本与配置，理解当前技术基线，识别可能需要更新的章节。 - 技术变更检测：分析依赖变更（新增包、版本更新、移除）、框架演进（主版本升级、破坏性变更）、工具采用（新的开发工具、linter、formatter、测试框架）、基础设施变化（部署、托管、监控）、数据库演进（schema 变更、新 ORM、迁移）以及集成更新（新 API、服务、认证提供商）。
- 自动比对：比较当前依赖与文档中记录的依赖，检查版本不匹配，识别新的配置文件，检测新的工具配置。
- 交互式技术问答：针对无法自动发现的基础设施变更、部署与托管更新、新的外部服务集成、工作流与流程变更提出针对性问题。
- 增量更新文档：保留准确的技术信息，精确更新版本号，为主要新增内容添加新章节，标记已弃用的技术。
- 保存与验证：建议对重大变更进行备份，验证所有版本准确无误。
使用方式
该技能通过用户请求参数 $ARGUMENTS 触发。执行时会读取项目根目录、package.json、当前技术文档及其最后修改时间，以及最近的 package 变更（通过 git diff 获取）。
执行步骤包括：
- 分析：使用 diff 比较当前依赖与文档中记录的依赖，查看最近的依赖提交，查找新的配置文件。
- 交互式问答：清晰呈现技术问题，包含文档中的当前状态，等待详细回复。
- 更新文档：采用增量方式，例如标注版本更新前后对比，或为新工具添加章节。
- 保存与备份：可选备份命令
cp .claude/rules/2-tech-stack.mdc .claude/rules/2-tech-stack.backup.md，然后覆盖保存更新后的文档。
技能包含一个技术问题模板，涵盖版本更新与依赖、基础设施演进、开发工作流更新、外部服务集成、安全与合规等类别。
适用场景
- 项目依赖发生变更后，需要同步更新技术栈文档。
- 框架主版本升级或引入破坏性变更时，记录迁移说明。
- 采用新的开发工具（如 linter、formatter、测试框架）后，补充文档。
- 部署、托管、数据库或外部服务集成发生变化时，更新基础设施描述。
限制
- 输出格式为 Markdown（.mdc），位置固定在
.claude/rules/，文件名固定为2-tech-stack.mdc（覆盖写入）。 - 文档中不得包含密钥或敏感数据。
- 只记录实际存在的内容，避免臆测；使用精确版本号而非模糊范围。
- 部分基础设施变更无法自动发现，依赖交互式问答补充。
- 关于收费、价格、平台支持范围等信息，资料中暂未提供。