메뉴
定期维护代码库健康度。扫描架构漂移、过期文档、低质量代码，防止技术债积累。应在完成若干任务后或怀疑代码库退化时触发。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
派遣 build-error-resolver 修复构建/类型/依赖/配置错误，不建 session
中文版 Java / Spring Boot 工程规约与代码 Review 标准。覆盖 Jakarta Validation 参数校验、空安全工具类、常量与枚举、Lombok/POJO、异常与日志、安全、MySQL/ORM、并发、单元测试、工程分层与 Review 清单。当用中文进行 Java/Spring Boot 代码生成、改造或 Review 时加载。
Generates Spring Boot 3.x configurations, creates REST controllers, implements Spring Security 6 authentication flows, sets up Spring Data JPA or MyBatis-Plus data access, and configures reactive WebFlux endpoints. Use when building Spring Boot 3.x applications, microservices, or reactive Java applications; invoke for Spring Data JPA, MyBatis-Plus, Spring Security 6, WebFlux, Spring Cloud integration, Java REST API design, or Microservices Java architecture.
Use when designing new high-level system architecture, reviewing existing designs, or making architectural decisions. Invoke to create architecture diagrams, write Architecture Decision Records (ADRs), evaluate technology trade-offs, design component interactions, and plan for scalability. Use for system design, architecture review, microservices structuring, ADR authoring, scalability planning, and infrastructure pattern selection — distinct from code-level design patterns or database-only design tasks.
Builds security-focused full-stack web applications by implementing integrated frontend and backend components with layered security at every level. Covers the complete stack from database to UI, enforcing auth, input validation, output encoding, and parameterized queries across all layers. Use when implementing features across frontend and backend, building REST APIs with corresponding UI, connecting frontend components to backend endpoints, creating end-to-end data flows from database to UI, or implementing CRUD operations with UI forms. Distinct from frontend-only, backend-only, or API-only skills in that it simultaneously addresses all three perspectives—Frontend, Backend, and Security—within a single implementation workflow. Invoke for full-stack feature work, web app development, authenticated API routes with views, microservices, real-time features, monorepo architecture, or technology selection decisions.
Optimizes database queries and improves performance across PostgreSQL and MySQL systems. Use when investigating slow queries, analyzing execution plans, or optimizing database performance. Invoke for index design, query rewrites, configuration tuning, partitioning strategies, lock contention resolution.
| name | entropy-management |
| description | 定期维护代码库健康度。扫描架构漂移、过期文档、低质量代码，防止技术债积累。应在完成若干任务后或怀疑代码库退化时触发。 |
AI Agent 会复制仓库中已有的模式——包括不好的模式。随着时间推移，这不可避免地导致漂移。 手动清理不可持续。熵管理将清理系统化，定期执行，像垃圾回收一样防止技术债积累。
核心原则：技术债是高利贷——持续小额偿还远优于积累后大规模清理。
发现的问题不能只修一次——必须同时编码为约束，防止再次发生。
每次熵管理运行结束后，必须更新质量评分和技术债追踪。
code-reviewer 审查中反复出现同类问题（模式漂移信号）运行 Harness 传感器套件收集机器可检测的问题：
node scripts/hooks/dispatcher.cjs stop
记录所有 [FAIL] 和 [WARN] 项。
自动化传感器无法覆盖的维度，需要人工/Agent 推理检查：
| 检查项 | 方法 |
|---|---|
| CLAUDE.md 引用路径是否有效 | 逐条验证文件/目录存在 |
| docs/ 文档描述是否匹配实际行为 | 抽样对比 |
| SKILL.md 中的流程是否被实际遵循 | 回顾近期任务记录 |
| 模板是否与当前实践一致 | 对比模板与近期产出 |
| 检查项 | 方法 |
|---|---|
| 是否有文件放在错误目录 | 检查目录约定是否被遵守 |
| 是否有重复/冗余文件 | 搜索相似文件名和内容 |
| 技能包结构是否一致 | 抽样检查 SKILL.md 格式 |
| 协作产物是否在正确位置 | 检查 .orchestration// 结构 |
| 检查项 | 方法 |
|---|---|
| 近期审查中的高频问题 | 分析 .orchestration//code-reviewer/ |
| 是否有被跳过的工作流阶段 | 检查产物完整性 |
| 是否有"沉默的传感器"（从不报错） | 评估传感器有效性 |
对发现的问题分类处理：
| 问题类型 | 处理方式 |
|---|---|
| 可快速修复的具体问题 | 立即修复（文档更新、文件移动等） |
| 需要编码为约束的重复模式 | 在 scripts/hooks/checks/ 加 check，让违规自动触发 [FAIL] |
| 需要架构讨论的系统性问题 | 与用户讨论；动手前先达成共识 |
把本次发现和处理沉淀到下列位置（按相关性挑，不必每次都全做）：
scripts/hooks/checks/ 加自动化 checkdocs/PROJECT_CONTEXT.md 或 docs/ARCHITECTURE.mddocs/rules/<topic>.md 或 docs/red-flags.md~/.claude/projects/<slug>/memory/，自动加载）docs/red-flags.mddocs/rules/<topic>.md每次熵管理运行后，应产出：
✅ dispatcher 扫描结果（node scripts/hooks/dispatcher.cjs stop）
✅ 推理型扫描发现清单
✅ 修复的问题列表
✅ 新增的约束 / check / 规则文档（如有）
| 信号 | 行动 |
|---|---|
| 传感器全部通过但直觉上代码库有问题 | 传感器覆盖不足，加新 check |
| 修复一个漂移又发现三个 | 可能是架构问题，先与用户讨论再动 |
| 反复出现同类问题但没有沉淀为约束 | 必须在 scripts/hooks/checks/ 加自动检测 |