用途
project-context-loader 用于在需要时加载项目约定并生成会话上下文，使 AI 在生成代码、重构或编写测试时遵循宿主项目的既有规范。资料明确说明该技能应在需要时显式使用，不自动触发。
主要能力
- 宿主项目文档优先：首次加载会话时完整阅读根目录及 .claude/ 下的 CLAUDE.md、README.md 以及可选的 CONTRIBUTING.md，这些人类撰写的文档优先级最高，与生成上下文冲突时以宿主项目文档为准，并应刷新缓存而非信任缓存。
- 缓存检查：若 .claude/session-context.toon 存在且较新（小于 1 小时）则直接使用。
- 缺失时生成：扫描代码库中的文件命名、导入风格、导出模式、错误处理、测试框架与样式方案，写入 .claude/session-context.toon。
- 加载项目配置：从 .claude/project-contexts/[project]/ 下按需读取 project-config.yaml、conventions.md、rules.md、repo-map.md、file-registry.yaml、architecture.md 等文件。
- 智能加载策略：简单问题仅用 session-context.toon；缺陷修复或小改动加载 session-context.toon、conventions.md、file-registry.yaml；新功能或重构加载全部 7 个文件；架构决策加载 session-context.toon、architecture.md、repo-map.md。
- Token 预算参考：简单约 200，缺陷修复约 800，完整约 2000，架构约 1000。
使用方式
在 /run、代码生成、重构、编写测试之前使用；简单问题（无代码）或会话上下文已加载时跳过。生成上下文命令为 bash scripts/context-compress.sh，强制重新扫描可删除缓存文件 rm .claude/session-context.toon。
适用场景
适用于需要让 AI 遵循项目既有约定进行代码生成、重构、测试编写与运行前准备的开发工作流。
限制
资料未提供具体支持的运行环境、依赖版本、错误处理机制及除 Claude 之外的其他模型兼容性信息；该技能自身不自动触发，需显式调用。