开发工具CLIAI 技能/插件测试人工智能AI 评测【免费下载链接】SuperClaude_FrameworkA configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies.项目地址https://gitcode.com/gh_mirrors/su/SuperClaude_Framework点击查看免费下载导读SuperClaude Framework 通过 Hooks钩子机制将 Claude Code 的会话生命周期与自动化行为深度绑定在会话启动时自动执行初始化脚本、在会话停止时检查未提交变更、在写/编辑工具调用后自动校验代码正确性。本文以 hooks/README.md 为骨架结合仓库内的完整 Hook 配置、初始化脚本与插件构建源码讲解 Hook 的目录结构、事件定义、同步机制与运行原理帮助你掌握在 SuperClaude 中配置和扩展事件驱动自动化的完整方法。一、Hooks 目录的角色定位src/superclaude/hooks/目录是 SuperClaude 中Hook 配置文件的存放位置其作用明确而单一hooks.json—— 事件驱动自动化event-driven automation的 Hook 定义文件README.md—— 说明该目录的职责、文件清单与维护规则。从文件结构看该目录位于 Python 包源码树src/superclaude/之下且__init__.py为空文件说明它并不承载 Python 逻辑而是作为随包分发的静态配置资源存在。真正被 Claude Code 消费的是hooks.json中声明的三个事件SessionStart / Stop / PostToolUse及其对应的命令与提示词。二、双源同步机制plugins 与 src 的一致性保障这是 hooks/README.md 的核心维护约定也是使用本目录前必须理解的关键规则本目录下的 Hook 文件是plugins/superclaude/hooks/的副本用于包分发package distribution。更新 Hooks 时必须遵循三步流程编辑plugins/superclaude/hooks/中的文件权威源将变更复制到src/superclaude/hooks/分发副本确保两处内容保持同步。同样的双源同步模式也出现在 scripts/README.md 中clean_command_names.py与session-init.sh均从plugins/superclaude/scripts/复制而来可以推断这是该框架包分发的统一约定plugins/是开发者直接维护、面向 Claude Code 运行时加载的目录src/内嵌于 Python 包用于通过 PyPI 等渠道分发时携带同款资源。v5.0 规划文档明确说明在 v5.0 版本中插件系统将直接使用plugins/目录届时双源同步的必要性将消除。这一演进路线与 build_superclaude_plugin.py 中「从单一权威源PLUGIN_SRC复制agents/commands/hooks/scripts/skills到分发目录」的构建思路一致可推断插件系统的未来形态是单一源头、统一分发。三、Hook 事件定义详解两份hooks.json的差异本身就是重要的实现事实先对比分发副本src/superclaude/hooks/hooks.json 仅声明了 SessionStart 事件{ hooks: { SessionStart: [ { hooks: [ { type: command, command: ./scripts/session-init.sh, timeout: 10 } ] } ] } }权威源plugins/superclaude/hooks/hooks.json 则包含完整的三个事件{ hooks: { SessionStart: [ { hooks: [ { type: command, command: ${CLAUDE_PLUGIN_ROOT}/scripts/session-init.sh, timeout: 10000 } ] } ], Stop: [ { hooks: [ { type: prompt, prompt: Before ending, check if there are uncommitted changes or incomplete tasks. If so, briefly note what remains to be done. } ] } ], PostToolUse: [ { matcher: Write|Edit, hooks: [ { type: prompt, prompt: Verify the edit was correct: check for syntax errors, missing imports, or broken logic in the changed file. If issues found, fix them immediately. } ] } ] } }三个事件的行为总结与 plugins/superclaude/README.md 中的 Hook 表格一一对应事件触发时机类型行为SessionStart会话启动时command执行session-init.sh初始化会话上下文Stop会话结束前prompt检查未提交变更与未完成任务并简要记录PostToolUse匹配Write\|Edit写/编辑工具调用后prompt校验修改正确性发现问题立即修复配置字段解读typecommand执行 Shell 命令或prompt向模型注入提示词指令commandcommand类型下要执行的命令路径timeout命令执行超时。注意两个文件的单位并不一致——分发副本中为10权威源中为10000。以权威源为准可推断 Claude Code 的 Hook 超时以毫秒计10000即 10 秒这与session-init.sh轻量化的设计目标相符脚本全部为即时输出无需长耗时matcherPostToolUse的事件匹配器Write|Edit表示仅当工具名为 Write 或 Edit 时触发${CLAUDE_PLUGIN_ROOT}Claude Code 插件环境变量指向插件根目录使 Hook 命令在插件被安装到任意位置时都能正确解析脚本路径。分发副本中写死的./scripts/session-init.sh是相对路径版本这也是两类文件使用场景差异的直接体现。四、SessionStart 初始化脚本剖析SessionStart事件调用的 session-init.sh 是理解整个 Hook 机制的钥匙。它在 Claude Code 会话启动时被自动执行完成三件事1. Git 状态探测if git status --porcelain /dev/null 21; then status$(git status --porcelain) if [ -z $status ]; then echo Git: clean else count$(echo $status | wc -l | tr -d ) echo Git: ${count} files fi else echo Git: not a repo fi通过git status --porcelain的返回值判断当前目录是否为 Git 仓库再依据输出是否为空区分「干净工作区」与「存在未提交变更」并统计变更文件数。--porcelain格式专为脚本解析设计输出稳定、不受用户 git 配置影响。2. Token 预算提醒echo Use /context to confirm token budget.提示开发者使用/context命令确认当前上下文窗口的 Token 预算——这与框架中token-efficiencyskill 及 token_budget.py 的上下文管理主题一脉相承会话启动时即建立 Token 成本意识。3. 核心服务就绪报告echo ️ Core Services Available: echo ✅ Confidence Check (pre-implementation validation) echo ✅ Deep Research (web/MCP integration) echo ✅ Repository Index (token-efficient exploration) echo echo SC Agent ready — awaiting task assignment.在会话启动时向模型与开发者通告三项核心能力Confidence Check实现前验证、Deep Researchweb/MCP 集成、Repository Indextoken 高效的仓库探索并以exit 0正常退出。这种「会话开场白」式的输出为后续 Agent 工作提供了上下文锚点。五、Stop 与 PostToolUse会话收尾与质量守门除初始化外Hook 还覆盖了会话的两端Stop 事件prompt 类型在会话结束前注入指令「检查是否存在未提交的变更或未完成的任务若有简要记录剩余工作」。它不执行命令而是约束模型的收尾行为确保工作交接清晰、不留隐患。PostToolUse 事件配合matcher: Write|Edit在每次写/编辑操作后注入校验指令「检查语法错误、缺失导入或逻辑破坏发现问题立即修复」。这让模型在每个修改动作之后自动进入一次轻量自检循环从机制层面降低引入回归的概率。三者共同构成「启动初始化 → 编辑自检 → 收尾交接」的完整会话生命周期闭环。六、Hook 资源如何进入最终分发物从 build_superclaude_plugin.py 的构建逻辑可以确认 Hook 在分发链路中的位置# Copy top-level asset directories for folder in [agents, commands, hooks, scripts, skills]: copy_tree(PLUGIN_SRC / folder, DIST_ROOT / folder)构建脚本以plugins/superclaude为唯一来源PLUGIN_SRC将hooks、scripts等目录整体复制到dist/plugins/superclaude/并生成插件清单plugin.json / marketplace.json。也就是说hooks.json与session-init.sh属于插件分发物中的一等公民资源与 agents、commands、skills 同级。这也反向印证了 README 的维护约定所有改动应先落在plugins/再同步到src/供包分发使用。七、本地验证与使用方式你可以直接在本仓库中验证 Hook 的行为无需修改任何文件查看权威配置plugins/superclaude/hooks/hooks.json 包含全部三个事件定义对比分发副本src/superclaude/hooks/hooks.json 与权威源核对同步状态执行初始化脚本手动运行bash src/superclaude/scripts/session-init.sh即可看到 Git 状态、Token 提醒与核心服务清单的输出脚本会以当前目录为基准探测 Git 状态本地加载插件使用claude --plugin-dir ./plugins/superclaude启动 Claude CodeSessionStart 钩子将随会话自动触发。总结SuperClaude 的 Hook 体系是一个「配置声明 脚本执行 提示词约束」的组合hooks.json声明事件与行为session-init.sh提供启动时的环境感知Stop / PostToolUse 提示词约束模型的收尾与自检。理解 hooks/README.md 所规定的双源同步规则与 v5.0 单一plugins/演进方向是后续向框架添加自定义自动化行为的基础——新增任何事件自动化都应遵循「先改权威源、再同步分发副本」的流程确保运行时加载与包分发两套路径行为一致。赞分享开发工具CLIAI 技能/插件测试人工智能AI 评测【免费下载链接】SuperClaude_FrameworkA configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies.项目地址https://gitcode.com/gh_mirrors/su/SuperClaude_Framework点击查看免费下载相关推荐gh_mirrors/docume/documentation架构方法论从零开始构建可扩展前端项目gh_mirrors/docume/documentation架构方法论从零开始构建可扩展前端项目 gh_mirrors/docume/documentatiZoom 会议全生命周期管理实战从 REST API CRUD 到 Webhook 事件驱动的完整实现Zoom 会议全生命周期管理实战从 REST API CRUD 到 Webhook 事件驱动的完整实现 导读 本文以 knowledge work plugiAI 技能AI 插件VS Code Copilot Hooks(.json):Agent 会话的确定性生命周期自动化机制详解VS Code Copilot Hooks .json :Agent 会话的确定性生命周期自动化机制详解 本文基于 VS Code 仓库中 Copilot 定制开发工具代码编辑器创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考