macos-tools/contexts

AI 上下文目录

这个目录包含了针对不同使用场景优化的 AI 上下文文件。

📁 文件说明

文件	大小	场景	Token消耗	何时使用
ai-context-core.md	~4KB	核心	~1000	快速检查、一般咨询
ai-context-dev.md	~4KB	开发	~2000	编写代码、构建应用
ai-context-deploy.md	~8KB	部署	~3000	K8s部署、镜像管理
ai-context-debug.md	~12KB	调试	~4000	故障排查、性能诊断

对比: 原始全量上下文 ../AI-CONTEXT.md (32KB, ~8000 tokens)

🚀 快速开始

方法1: 直接生成（推荐）

# 回到项目根目录
cd /Users/brunogao/work/codes/tools/macos

# 根据任务生成对应场景
./scripts/ai-context-optimizer.sh dev      # 开发
./scripts/ai-context-optimizer.sh deploy   # 部署
./scripts/ai-context-optimizer.sh debug    # 调试
./scripts/ai-context-optimizer.sh core     # 核心
./scripts/ai-context-optimizer.sh auto     # 智能推荐

方法2: 使用别名（更快）

# 添加到 ~/.zshrc
alias ai-dev='cd ~/work/codes/tools/macos && ./scripts/ai-context-optimizer.sh dev'
alias ai-deploy='cd ~/work/codes/tools/macos && ./scripts/ai-context-optimizer.sh deploy'
alias ai-debug='cd ~/work/codes/tools/macos && ./scripts/ai-context-optimizer.sh debug'
alias ai-core='cd ~/work/codes/tools/macos && ./scripts/ai-context-optimizer.sh core'

# 重新加载
source ~/.zshrc

# 使用
ai-dev     # 生成开发上下文
ai-deploy  # 生成部署上下文

💡 使用示例

场景1: 日常开发

# 1. 生成开发上下文
ai-dev

# 2. 在 Claude Code 中
# "请阅读 contexts/ai-context-dev.md"
# "帮我创建一个 Docker 镜像并推送到 Harbor"

效果:

• Token 消耗: ~2000 (vs 原来的 8000)
• 响应速度: 快 2-3 倍
• 信息准确性: 更高（只包含开发相关信息）

场景2: K8s 部署

# 1. 生成部署上下文
ai-deploy

# 2. 在 Claude Code 中
# "请阅读 contexts/ai-context-deploy.md"
# "帮我部署一个 Nginx 到 K8s，并配置镜像缓存"

效果:

• 包含完整的 K8s 集群状态
• 包含镜像缓存工具使用指南
• 包含详细的部署流程

场景3: 故障排查

# 1. 生成调试上下文
ai-debug

# 2. 在 Claude Code 中
# "请阅读 contexts/ai-context-debug.md"
# "我的 Pod 一直 CrashLoopBackOff，帮我分析原因"

效果:

• 包含系统健康检查结果
• 包含异常 Pod 列表
• 包含专业的故障排查步骤

📊 优化效果

Token 消耗对比

原始全量上下文: ████████████████████████████████ 8000 tokens
核心上下文:     ████                             1000 tokens (-87%)
开发场景:       ████████                         2000 tokens (-75%)
部署场景:       ████████████                     3000 tokens (-62%)
调试场景:       ████████████████                 4000 tokens (-50%)

成本节省

月度对话量: 假设每天 20 次对话，平均 5 轮/次

方式	Token消耗/月	成本/月*	年成本	节省
原始全量	2,400,000	$72	$864	-
优化场景	600,000	$18	$216	$648/年

* 基于 Claude Sonnet $3/M input tokens

ROI: 节省 75% 成本 🎯

🔒 安全模式

如需分享上下文文件或避免敏感信息泄露，使用安全模式：

# 生成安全版本（自动过滤密码、Token等）
./scripts/ai-context-optimizer.sh dev --secure

# 输出到自定义位置
./scripts/ai-context-optimizer.sh deploy --secure -o ~/team-context.md

过滤内容:

• 密码 (password)
• API 密钥 (api_key)
• Token
• 凭据中的敏感部分

示例:

原始: admin/admin123
过滤: admin/***FILTERED***

🎯 最佳实践

1. 选择合适的场景

你的任务	选择场景
写代码、调试代码	dev
构建 Docker 镜像	dev
部署到 K8s	deploy
修复 Pod 问题	debug
分析性能问题	debug
快速查询信息	core
不确定	auto

2. 适时切换场景

在一次对话中，可以根据任务变化切换场景：

# 开始开发
ai-dev
# Claude: "请阅读 contexts/ai-context-dev.md"

# ... 开发完成后部署 ...

# 切换到部署场景
ai-deploy
# Claude: "现在请阅读 contexts/ai-context-deploy.md"

# ... 遇到问题 ...

# 切换到调试场景
ai-debug
# Claude: "现在请阅读 contexts/ai-context-debug.md"

3. 定期更新

建议在以下情况下重新生成上下文：

• ✅ 每天开始工作前
• ✅ 部署新服务后
• ✅ 系统配置变更后
• ✅ 遇到问题需要最新状态时

4. 团队协作

# 生成安全版本供团队使用
./scripts/ai-context-optimizer.sh dev --secure -o team-dev-context.md

# 提交到版本控制
git add contexts/team-dev-context.md
git commit -m "docs: 更新团队开发上下文"

📚 相关文档

• 优化器脚本: ../scripts/ai-context-optimizer.sh
• 优化分析报告: ../AI-CONTEXT-OPTIMIZATION.md
• 使用指南: ../AI-CONTEXT-GUIDE.md
• 项目说明: ../CLAUDE.md

🆘 常见问题

Q: 应该使用哪个场景？

A: 根据当前任务选择：

• 编写代码 → dev
• 部署应用 → deploy
• 解决问题 → debug
• 快速检查 → core
• 不确定 → auto（自动推荐）

Q: 可以在一次对话中使用多个上下文吗？

A: 可以，但建议逐个使用：

你: "请阅读 contexts/ai-context-dev.md"
Claude: [理解开发环境]
你: "帮我创建应用"
...
你: "现在请阅读 contexts/ai-context-deploy.md"
Claude: [理解部署环境]
你: "帮我部署"

Q: 安全模式会过滤哪些信息？

A: 自动过滤：

• 密码 (password=xxx → password=***FILTERED***)
• API 密钥 (api_key=xxx → api_key=***FILTERED***)
• Token (token=xxx → token=***FILTERED***)
• 凭据 (admin/pass123 → admin/***FILTERED***)

Q: 如何查看当前有哪些上下文文件？

A:

ls -lh contexts/

Q: 文件太老了怎么办？

A: 重新生成即可：

ai-dev    # 更新开发上下文
ai-deploy # 更新部署上下文

🔄 更新历史

• 2025-12-30: 创建场景化上下文系统 (v2.0)
• 2025-12-30: 添加安全模式和智能推荐
• 2025-12-30: 优化 Token 消耗，提升响应速度

---

提示: 这些上下文文件会自动生成，无需手动编辑。如需更新，请重新运行生成脚本。