SuperAPI AI 工具集

project-context-loader

通用与其它

查看项目

更新于 10-16 01:37

技能介绍

用途:在需要时加载项目约定并生成会话上下文,供 AI 执行时参考。官方说明强调应显式使用,而非自动触发。

主要能力与流程:

  1. 优先读取宿主项目自身文档,且其优先级高于本技能推断的内容:CLAUDE.md(根目录或 .claude/CLAUDE.md)为最高优先级;README.md 为高优先级,含用途、安装、运行命令与结构;CONTRIBUTING.md(若存在)为变更约定。首次加载会话时应完整阅读,冲突时以宿主项目文档为准并刷新缓存。
  2. 检查缓存:若 .claude/session-context.toon 存在且较新(小于 1 小时)则直接使用。
  3. 缺失时生成:扫描代码库中的文件命名、导入风格、导出模式、错误处理、测试框架、样式方案,写入 .claude/session-context.toon。
  4. 加载项目配置:从 .claude/project-contexts/[project]/ 读取 project-config.yaml、conventions.md、rules.md(始终)、repo-map.md(首个任务)、file-registry.yaml(修改代码时)、architecture.md(架构决策时)。
  5. 智能加载策略:简单问题仅用 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、代码生成、重构、测试编写前使用;简单问题(无代码)或 session-context.toon 已加载时跳过。命令:bash scripts/context-compress.sh 生成上下文;rm .claude/session-context.toon 强制重新扫描。

限制:资料未提供具体安装方式、收费、平台支持或效果数据;其行为依赖宿主项目文档与缓存时效。