detect-stack

检测技术栈

分析当前代码库并生成 .agents/stack-context.md。在项目中首次使用时，或技术栈上下文缺失或过时时运行。

检测内容

扫描项目根目录，查找以下信号：

语言 — 统计文件扩展名（.rs、.py、.ts、.go、.swift、.java、.rb、.cs、.ex 等）。主要语言 = 文件数量最多的语言。记录次要语言。

框架 — 读取包清单文件：

• Cargo.toml → 检查 [dependencies] 中是否有 axum、actix、rocket、sqlx、diesel、tokio
• package.json → 检查是否有 react、next、svelte、express、fastify、prisma
• go.mod → 检查是否有 gin、echo、fiber、chi、sqlc
• pyproject.toml / requirements.txt → 检查是否有 django、flask、fastapi、sqlalchemy
• Gemfile → 检查是否有 rails、sinatra
• Package.swift → 检查是否有 Vapor；扫描 SwiftUI 导入语句
• mix.exs → 检查是否有 phoenix、ecto

测试 — 查找测试目录、测试文件命名模式和测试配置文件。

CI 门禁 — 扫描 .github/workflows/、.gitlab-ci.yml 等，查找阻断性检查（格式、lint、类型检查、测试）。

约定 — 检查 CLAUDE.md、AGENTS.md、CONTRIBUTING.md。记录目录结构和命名模式。

输出

写入 .agents/stack-context.md，保持简短（少于 40 行）：

# Stack Context

Generated: YYYY-MM-DD

## Stack
- **Language**: [primary] [version if pinned]
- **Framework**: [web framework], [db layer]
- **Build**: [build tool]
- **Test**: [test command + framework]
- **Lint**: [linter] [CI gate: yes/no]
- **Format**: [formatter] [CI gate: yes/no]

## Secondary Languages
- [language] ([what it's used for])

## Conventions
- Error handling: [pattern]
- Module structure: [pattern]
- Naming: [pattern]
- Tests: [where they live, how they're organized]

## CI Gates
- [list of blocking checks]

特定技术栈的原则应用

写入技术栈上下文后，不要生成静态参考文件。而是：

1. 运用你对检测到的语言和框架的内置知识，以符合其惯用方式的形式应用各项编码原则
2. 如果需要了解特定框架 API 的详细信息，请使用 context7 MCP（先执行 resolve-library-id，再执行 query-docs）获取最新文档
3. 如果 context7 未涵盖相关内容，则使用网络搜索作为备用方案

编码原则技能在设计上与语言无关。你需要在原则与技术栈之间起到桥梁作用。

何时重新运行

• .agents/stack-context.md 不存在
• 主要依赖发生变化（新增框架、语言版本升级）
• 项目结构发生重大变化
• 上下文文件已超过 30 天未更新