菲尔艾上下文
优化AGENTS.md文件,管理MCP配置,高效加载上下文。
新用户快速入门
预先批准技能,加快工作流程:将此添加到您的克劳德代码设置中:
{
"approvedSkills": [
"phil-ai-context:optimize-agents-context",
"phil-ai-context:optimize-mcp-config",
"phil-ai-context:add-task"
]
}益处:命令如下 /optimize-agents 将在没有提示的情况下运行。
特性
- AGENTS.md优化:具有层次感知的令牌高效上下文文件
- 智能上下文加载:仅加载基于层次结构级别的相关上下文
- MCP配置管理:优化MCP服务器设置和文档
- 层级管理:检测和导航全局/配置文件/项目/代理级别
- 配置文件感知:在工作/娱乐/家庭中尊重不同的标准
- 任务管理:层次感知任务跟踪和管理
安装
/plugin marketplace add pjbeyer/phil-ai
/plugin install phil-ai-context@phil-ai命令
/optimize-agents
跨层次优化AGENTS.md文件以提高令牌效率。
# Optimize all AGENTS.md files
/optimize-agents它的作用:
- 发现层次结构中的所有AGENTS.md文件
- 测量字符/令牌使用情况
- 检测不同级别的冗余
- 将详细内容提取到文档中/
- 提供优化建议
- 跟踪实现的节约
目标预算:
- 全局:8-12k个字符
- 配置文件:5-8k字符
- 项目:4-6k字符
- 代理:2-6k个字符
/optimize-mcp
优化MCP服务器配置和文档。
# Optimize MCP setup
/optimize-mcp它的作用:
- 发现所有.mcp.json配置
- 按配置文件清点MCP服务器
- 分析文档层次结构
- 识别冗余的MCP文档
- 验证集成
- 文档交叉配置文件模式
/optimize-settings
优化克劳德代码设置配置和管理。
# Optimize settings (context-adaptive)
/optimize-settings
# Force specific mode
/optimize-settings --global
/optimize-settings --user-only
# Dry run (show recommendations only)
/optimize-settings --dry-run它的作用:
- 检测上下文并调整范围
- 发现所有相关设置文件
- 分析:整合、安全、迁移、性能、最佳实践
- 按优先级分类(高/中/低)
- 交互式审批流程
- 全面的文件
上下文模式:
- 全局:扫描所有配置文件/项目
- 项目:分析用户+当前项目
- 用户:仅限用户级别设置
/add-task
将任务添加到支持层次结构的任务管理中。
# Add task at current level
/add-task任务层次结构:
- 全球任务:横向改进
- 配置文件任务:特定工作简介
- 项目任务:项目功能和修复
- 代理任务:代理改进
技能
优化技能(3)
- 优化代理上下文:AGENTS.md优化和令牌效率
- 优化mcp配置:MCP配置和文档优化
- 优化设置:使用基于优先级的建议进行设置优化
层次技能(3)
- 检测配置文件:检测当前配置文件(pjbeyer/工作/游戏/家庭/全局)
- 检测电平:检测层次结构级别(全局/配置文件/项目/代理)
- 导航层次结构:在级别之间导航,查找父母/子女
语境技能(2)
- 负载代理上下文:基于级别的智能上下文加载
- 分析上下文使用情况:分析令牌使用情况并确定优化
任务技能(2)
- 添加任务:将任务添加到适当的层次结构级别
- 管理任务:跨层次管理任务
分级组织
层次结构级别
全球 (~/Projects):
- 跨配置文件模式、环境设置、配置文件管理
个人资料 (~/Projects/{profile}):
- 简介理念、标准、技术栈、工作流程
项目 (~/Projects/{profile}/{project}):
- 项目架构、代理注册表、路由、集成
代理 (~/Projects/{profile}/{project}/agents/{agent}):
- 代理规范、工作流、集成点、子代理
智能上下文加载
仅加载基于当前级别的相关AGENTS.md文件:
代理级别:
- 负载:代理→ 项目→ 配置文件(跳过全局)
- 代币节省:40%(15k比25k字符)
项目级:
- 负载:项目→ 个人资料→ 全球的
- 完整上下文 用于横向工作
配置文件级别:
- 负载:配置文件→ 全球的
- 两个级别 用于剖面工作
全球层面:
- 负载:仅全局
- 最小化 全球运营
配置文件特定标准
pjbeyer个人资料
- 质量:专业,以客户为中心
- 文档:全面但高效(4-6k字符)
- 测试:80%以上的覆盖率
工作概况
- 质量:企业,安全第一
- 文档:精简(3-5k字符目标)
- 测试:关键路径为90%+
播放配置文件
- 质量:快速迭代,实验性
- 文档:灵活(2-4k字符)
- 测试:最小
主页简介
- 质量:实用、方便
- 文档:简单(2-4k个字符)
- 测试:以任务为导向
代币效率策略
提取到/docs/
- 程序 → 文档/工作流/
- 例子 → 文档/示例/
- 背景 → 文档/架构/
- 详细列表 → 文档/参考/
参考,不要重复
# Profile AGENTS.md (BEFORE)
Git configuration: [500 chars duplicated from global]
# Profile AGENTS.md (AFTER)
Git configuration: See global AGENTS.md内容整合
# BEFORE (200 tokens)
- Feature 1: This comprehensive feature provides...
- Feature 2: This powerful feature enables...
# AFTER (60 tokens)
Features: [Feature 1], [Feature 2], [Feature 3]
Details: docs/features.md配置
三个配置文件定义了行为:
hierarchy-config.json
- 每个级别的代币预算
- 加载策略
- 层次结构原则
profile-definitions.json
- 简介目的和标准
- 检测规则
- Git配置位置
context-rules.json
- 优化规则
- 内容分类
- MCP规则
与其他插件集成
菲尔艾医生
- 使用上下文系统进行AGENTS.md优化
- 使用令牌预算编写机器文档
- 分层文档协调
菲尔艾学习
- 在适当的层次结构中获取的学习成果
- 情境感知学习存储
哲学
分级组织
信息只存在于一个层次。较低级别参考,而不是重复,较高级别。
代币效率
对于机器可读的文档,每个令牌都很重要。将细节提取到/docs/,将要点保存在AGENTS.md中。
配置文件感知
不同的配置文件有不同的标准。尊重他们。
智能加载
只装载需要的东西。代理级别的工作不需要全局上下文。
发展
结构
phil-ai-context/
├── .claude-plugin/
│ └── plugin.json
├── skills/
│ ├── optimization/ # 2 skills
│ ├── hierarchy/ # 3 skills
│ ├── context/ # 2 skills
│ └── tasks/ # 2 skills
├── commands/
│ ├── optimize-agents.md
│ ├── optimize-mcp.md
│ └── add-task.md
├── config/
│ ├── hierarchy-config.json
│ ├── profile-definitions.json
│ └── context-rules.json
└── docs/
└── README.md本地测试
- 创建开发市场
- 安装以进行测试
- 重新启动Claude代码和测试命令
例子
优化AGENTS.md文件
cd ~/Projects/work
/optimize-agents
# Output:
# Analyzing 23 AGENTS.md files...
# Total: 112,334 chars
# Over budget: 8 files
# Potential savings: 31% (35,000 chars)
#
# Recommendations:
# 1. Extract MCP details to docs/mcp/ (save 15k)
# 2. Reference global git config (save 2k)
# 3. Move examples to docs/examples/ (save 18k)智能上下文加载
# Working at agent level
cd ~/Projects/work/security-agents/agents/scanner
# Context loaded:
# - agent/AGENTS.md (3k chars)
# - project/AGENTS.md (5k chars)
# - profile/AGENTS.md (7k chars)
# Total: 15k chars (vs 25k if all levels loaded)添加任务
cd ~/Projects/work/security-project
/add-task
# Creates: ~/Projects/work/security-project/docs/tasks/project.md
# With proper format and context awareness许可证
MIT许可证
仓库
https://github.com/pjbeyer/phil-ai-context
