工程开发
cc-stack-analysis avatar

cc-stack-analysis

用于审核和验证 Claude Code 配置(技能、钩子、指令)的结构完整性、命名规范及最佳实践的专家工具。

简介

cc-stack-analysis 技能充当您 Claude Code 元配置和项目特定设置的全面质量保证代理。它的设计目的是通过区分元级配置(Claude Code 工具配置)和领域特定实现逻辑,来维护架构的一致性。通过自动化 .claude/ 目录的清单和验证,它确保您的项目保持高性能、安全并符合标准开发规范。

  • 对技能、指令和钩子进行深度的结构化盘点,以识别孤立文件或格式错误的元数据。
  • 验证命名规范以防止作用域冲突,确保正确应用前缀(cc- 用于元配置,项目特定前缀用于领域逻辑)。
  • 分析 SKILL.md 文件中的 YAML frontmatter,验证必填字段、作用域、目标和关键字相关性,防止常见的配置漂移。
  • 执行自动化检查,包括脚本权限 (chmod +x)、shebang 一致性以及生命周期钩子的 JSON 输入/输出完整性。
  • 检测元技能与领域技能之间的潜在关键字重叠,以消除歧义并提高自动发现期间的模型精确度。
  • 提供关于 settings.json 维护的可操作建议,确保钩子注册与实际文件系统路径匹配。

此工具适用于管理复杂 Claude Code 部署的开发人员和架构师。它处理常见的操作限制,例如确保钩子执行时间保持在建议的阈值以下,且配置深度不超过可维护的限度。当团队成员加入代码库、在 .claude/ 目录中进行大规模重构后,或作为预提交质量审核过程的一部分时,用户应利用此技能。通过专注于代理编排的结构“健康度”,它降低了工具错误触发的可能性,并提高了自动化开发工作流程的整体可靠性。

仓库统计

Star 数
0
Fork 数
0
Open Issue 数
0
主要语言
Shell
默认分支
main
同步状态
空闲
最近同步时间
2026年5月4日 01:59
在 GitHub 查看