SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场session-start-routine

session-start-routine

智能体与模型

查看项目

更新于 10-16 06:09

技能介绍

用途

Session Start Routine 是一个元技能（meta-skill），定义了强制性的工作会话初始化例程。按照其设计，在每次对话开始时，Claude 应执行该例程，以维护和改进技能库。它适用于新对话的第一条消息、通过 /session-start-routine 显式请求时、会话间隔较久之后，以及发现技能相关问题时。

主要能力

该技能围绕五个步骤展开：

  1. 技能健康检查：扫描用户级（~/.claude/skills/）与项目级（.claude/skills/）两个位置，验证每个技能的 SKILL.md 是否存在且有效，检查版本历史与最后更新日期，标记 30 天以上未更新的技能，并验证依赖（工具/库、MCP 服务器、代码示例）是否仍然有效。

  2. 集成检查：列出引用 MCP 服务器的技能，验证这些服务器是否存在于 ~/.claude.json 或 .mcp.json 中，检查已弃用的 MCP 工具名；同时验证技能与当前 Claude Code 智能体的兼容性，检查已弃用的智能体模式。

  3. 跨技能依赖：提取“Related Skills”部分，识别技能之间的引用关系，检测孤立或循环依赖，并构建依赖图。

  4. 研究与改进识别：针对每个技能类别，研究官方文档更新（Anthropic Claude 文档、工具/库变更日志）、社区最佳实践（GitHub 趋势仓库、Stack Overflow 讨论）以及行业趋势（新工具/库、方法论更新、安全公告）。

  5. 技能更新与新技能识别：对需要更新的技能研究最新最佳实践，识别具体改进点（新增功能、移除已弃用方法、更好的代码示例、性能优化），并以版本注释形式应用更新；同时基于能力缺口、常见工作流模式和行业趋势评估新技能需求。

  6. 文档更新：更新 skills/README.md，记录新增、更新和弃用的技能，并以描述性消息提交变更。

使用方式

触发方式为说出“session start”或使用 /session-start-routine。快速健康检查命令示例：

# Quick health check command
find ~/.claude/skills -name "SKILL.md" -mtime +30 -exec echo "Stale: {}" \;

# Count skills
find ~/.claude/skills -name "SKILL.md" | wc -l

更新后的提交模式示例：

# Commit pattern for skill updates
git add ~/.claude/skills/
git commit -m "chore(skills): session update - [YYYY-MM-DD]

- Updated: [skill1], [skill2]
- Added: [new-skill]
- Research: [topic]"

例程结束时按模板生成会话报告，包含技能健康统计、本次改进、识别出的新技能、研究发现和下次会话优先级。

版本与弃用管理

版本号采用 MAJOR.MINOR.PATCH 格式：MAJOR 为破坏性变更或完全重写，MINOR 为新功能或重大改进，PATCH 为缺陷修复、小更新或拼写修正。版本注释添加在 SKILL.md 末尾的 Version History 部分。

弃用标准包括：90 天以上未更新、引用已弃用的工具/API、被更好的技能取代、60 天以上零使用。弃用流程为：在描述前加 DEPRECATED 前缀、在 SKILL.md 顶部添加弃用通知、指向替代技能、30 天宽限期后移除。

适用场景

适用于使用 Claude Code 并维护技能库的用户，尤其是需要在每次会话开始时自动检查技能健康度、保持技能与最新工具和文档同步、跟踪技能使用情况并优先改进高频技能的团队或个人。

限制

该技能依赖对技能目录的访问权限；网络研究为可选项。常见错误包括技能目录不可访问、SKILL.md 解析失败、MCP 服务器未找到、检测到循环依赖、过时技能过多等，文档中给出了对应的原因与解决方案。技能可能位于用户级或工作区级，具体位置需按实际情况确认。