# AI Coding Guideline

> AI 编程指南，包含上下文管理、提示词缓存、技能系统等核心内容

## 开始

- [总览:AI 编程的核心心智模型](https://guide.optimax.hk/guide): 从聊天问答与编程智能体的差别出发，说明上下文窗口为何稀缺、缓存如何决定成本与速度，以及怎样把找上下文的开销工程化掉

## 基础概念

- [什么是 Tokenize(分词)](https://guide.optimax.hk/guide/tokenization): 大语言模型并不直接处理字符，而是处理 token；本文说明中英文与代码的分词差异，以及它如何决定调用成本、窗口预算和往上下文里塞文档的写法
- [上下文窗口与 1M 的区别](https://guide.optimax.hk/guide/context-window): 说明编程智能体的上下文窗口由系统提示、工具定义和对话历史构成，介绍查看占用的方法，并比较默认窗口与超长模式在容量、价格与质量上的差异
- [模型怎么选:Claude 与 GPT 家族](https://guide.optimax.hk/guide/models): 选模型应按任务难度、时长与预算匹配档位，而不是永远用最强；本文介绍 Claude 与 GPT 家族各自适合的工作，以及思考强度和思考预算怎么用

## 缓存 Prompt Caching

- [缓存是什么、如何控制](https://guide.optimax.hk/guide/prompt-caching): 全面详解提示缓存的前缀匹配规则、cache_control断点设置及跨API降低长会话输入成本至约一折的方法
- [为什么第一次调用更贵](https://guide.optimax.hk/guide/cache-write-cost): 详解缓存写入成本的构成、计费规则、回本时机与无效成本场景，帮你全面清晰掌握AI编程缓存的核心价格逻辑与实用避坑技巧
- [避免大上下文反复重建缓存](https://guide.optimax.hk/guide/cache-strategy): 全面详细介绍破坏上下文缓存的常见因素与实用规避方法，以及保持缓存命中的实践守则，有效降低大上下文重建的高额成本

## 上下文工程实践

- [避免工具爆炸导致上下文爆炸](https://guide.optimax.hk/guide/tool-explosion): 全面详解MCP工具定义导致上下文膨胀的原理、成本影响与各类解决方案
- [子代理:保护主窗口的关键手段](https://guide.optimax.hk/guide/subagents): 详解子代理如何通过独立上下文窗口隔离高噪音工作，以及常见适用场景、不适用场景与核心使用方法和实用配置规范与注意事项
- [会话生命周期:compact、clear 与恢复](https://guide.optimax.hk/guide/sessions): 全面详解会话生命周期中compact、clear、resume与检查点的使用时机，以及基于文件化状态运行长任务的最佳实践方法
- [用 Skills 辅助开发](https://guide.optimax.hk/guide/skills): 全面介绍Agent Skill的渐进式加载机制，讲解固化团队开发经验为标准化工作流的方法
- [用 RepoPrompt 降低 Agent 找文件的开销](https://guide.optimax.hk/guide/repoprompt): 全面讲解RepoPrompt的方法与原理，帮助AI编程Agent减少文件查找时的Token开销，提升开发效率

## 安全

- [权限与安全](https://guide.optimax.hk/guide/permissions): 全面详解AI编程Agent的权限模式、安全配置规则，提示注入等安全风险与防护方案及项目级配置最佳实践

## Skills 推荐

- [Skills 推荐:怎么选、怎么组合](https://guide.optimax.hk/guide/skills-picks): 全面推荐经过社区大规模验证的第三方Skill，帮助治理AI编程中的过度工程与AI味前端设计问题
- [Ponytail:让 Agent 少写代码](https://guide.optimax.hk/guide/skills-ponytail): 全面介绍Ponytail工具通过YAGNI原则帮助AI Agent减少冗余代码、优化上下文Token成本的方法
- [前端双子星:ui-ux-pro-max 与 Impeccable](https://guide.optimax.hk/guide/skills-frontend): 全面对比ui-ux-pro-max与Impeccable两款Skill，讲解互补治理AI生成前端设计审美问题的方法

## Other

- [AI Coding Guideline](https://guide.optimax.hk/): 本指南面向 Claude Code、Codex 给出可落地实践，说明聊天问答与自主工具调用的本质差别，以及上下文、缓存和工程化如何决定速度、成本与质量