clean-code

用途：在任意语言或框架中编写、编辑、评审、测试、规划或重构代码，以及创建文件或决定代码与目录位置时使用。核心是整洁代码与整洁架构（Clean Code And Clean Architecture）。\n\n主要能力：提供一整套操作规范与检查清单。包括首次编辑前加载上下文（栈、包、分层、决策、结构、项目说明），遵循操作循环（框定需求、阅读邻近代码、定位归属、外科式编辑、验证、按评审清单复查 diff），以及始终适用的规则：按角色放置文件、单一职责、最小代码、命名揭示意图、错误不吞没、测试先行与保持、安全校验。若声明了分层，则执行依赖规则：源码依赖只向内指向高层策略，业务规则最高层，SQL 留在数据访问层，组件图无环。\n\n使用方式：通过 /clean-code 加参数（也支持 $clean-code、@clean-code、/skill:clean-code）或自然语言触发，路由一致。参数包括 init（或 questions、interview me）、audit、clean-up、new-project <description>、plan <task>、review [files]、compress [files]；无参数时读取本技能主文件。脚本有 detect_stack.py、scan_repo.py、map_structure.py、check_boundaries.py、check_compression.py，其输出为证据而非结论。\n\n适用场景：日常代码编辑与评审、缺陷修复（先写复现测试）、重构（前后均跑测试）、新项目搭建、任务规划、项目审计与压缩清理、多步骤或可恢复会话。\n\n限制：仅 init、audit、new-project 会创建 .clean/ 目录，普通会话只读取并在结尾询问是否持久化；琐碎编辑（如拼写、注释）可跳过上下文门与评审清单；范围模式分外科式（默认，只改最小切片，无关问题仅报告）与战役式（需明确请求）；审计与评审、规划模式不改代码；压缩永不触碰托管块。