🧠 Skills 工作原理

每个 Skill 是一个独立的 ~/.claude/skills/<name>/SKILL.md 文件，包含：

• YAML 前置元数据：名称、描述、是否可手动调用（user-invokable: true）、调用参数
• Markdown 指令正文：定义触发条件、工作流程、输出格式、约束规则
• 辅助文件：同一目录下的 .md/.sh/.ts 等资源

🤖 Agents 工作原理

每个 Agent 是 ~/.claude/agents/<name>.md，包含：

• model：指定运行模型（sonnet/opus/haiku），决定推理深度和成本
• tools：可用工具白名单，限制 Agent 的操作范围
• 系统提示词：定义角色、行为准则、输出格式

🔗 Skills 之间的关联

• 前缀聚类：同名前缀属于同一领域（seo-*，laravel-*，react-* 等）
• 文档交叉引用：一个 skill 的正文中明确提到另一个 skill 的名称
• 功能闭环：systematic-debugging → tdd → code-review → security-review 构成开发全流程
• Agent-Skill 映射：同名 agent 是 skill 的运行时执行器

⚡ 调用方式

方式	语法	说明
斜杠命令	/skill-name	直接调用（仅 user-invokable skills）
自然语言	描述需求	AI 自动匹配相关 skill
Agent 调用	Skill("name")	编程式调用
插件限定	plugin:skill	命名空间调用

🔄 自动更新

• 页面加载时检查目录内所有文件的修改时间（mtime）
• 任一文件变化 → 自动重扫（约1-2秒）
• 缓存 1 小时强制过期
• 手动 ?refresh=1 立即重建