القائمة
当用户主动纠正 AI 的编码规范错误时（如分层依赖违规、命名不规范、架构约束违反等），必须立即触发本 skill。同时，每次开始编写代码前，必须先读取项目的编码违规记录文档。触发短语：'这样写不对'、'不能引用这个层'、'分层违规'、'改一下依赖方向'、'这个不符合规范'，或用户否定了当前代码写法并给出正确方向时。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when writing, reviewing, or modifying source code in any language (Java / TypeScript / JavaScript / Dart / Python / Kotlin / Go / Vue / React 等). 跨语言通用编码铁律 7 条 + 注释三档,语言专属 skill (java-coding-standards / korepos-backend-service 等) 在此基础上叠加。MUST 自动触发,不需用户显式要求。
Use when writing, reviewing, or modifying any Java code. You MUST follow these mandatory rules at all times. Apply automatically without being asked. 通用条款见 coding-standards-common；本文件仅列 Java 独占规则（阿里巴巴黄山版强制项的 Java 专属部分）。
Use when the user asks to commit code or generate a commit message AND the staged diff is non-trivial (>2 files, >30 net lines, or contains new/renamed/deleted files). For trivial commits (≤2 files, ≤30 lines, only modifications to existing files) skip this skill and write a clear `git commit` message directly — `hooks/check-git-commit-skill.js` enforces the same threshold at the Bash layer (only blocks `git commit` when staged diff exceeds it). Compose the message from the current session's edit intent first; only re-read diffs to cover gaps. Automatic stage/commit/push applies ONLY to the team-standards plugin source repository, never to business projects that merely install this plugin.
Use BEFORE answering single-service backend questions about table relations / ER / SQL / state transitions / atomic capabilities or project-level technical pain points (subprocess, concurrency, perf, external deps); BEFORE Write/Edit any .md describing such content (anywhere — docs/, ai-docs/, scenarios/, work-log/). Auto-append candidates to `_candidates.md` after investigation discovers reusable facts, or when same tech concern raised ≥3 rounds in one session. Knowledge graph ownership = investigated service, not cwd. Detailed triggers (7 BLOCKING conditions) and scope boundaries listed in `## BLOCKING 强触发清单` section of SKILL.md body.
Use when writing or modifying code that integrates an LLM or builds an agent —— imports langchain4j / spring-ai / openai / anthropic 等 SDK；定义 @Tool / AiService / function-calling 工具；拼装 prompt；解析 LLM 输出。在 coding-standards-common 之上叠加的 LLM/Agent 集成编码铁律：确定性优先、LLM 输出当不可信入参、模糊→结构化用受控枚举、约定单一来源、工具描述是运行时契约、Agent 循环必须兜底、上下文由代码注入。MUST 自动触发，先满足 coding-standards-common 再走本 skill。
当用户要求「架构检查」「lint」「检测架构违规」时触发；当对 Flutter 项目的 presentation/domain/data/infrastructure 层代码执行 Edit/Write 后自动触发一次轻量检查。
| name | coding-violation-log |
| description | 当用户主动纠正 AI 的编码规范错误时（如分层依赖违规、命名不规范、架构约束违反等），必须立即触发本 skill。同时，每次开始编写代码前，必须先读取项目的编码违规记录文档。触发短语：'这样写不对'、'不能引用这个层'、'分层违规'、'改一下依赖方向'、'这个不符合规范'，或用户否定了当前代码写法并给出正确方向时。 |
被纠正的错误必须登记，登记的错误不能再犯。
本 Skill 建立"犯错→登记→编码前回顾"的闭环，确保同一类编码规范错误不会在项目中反复出现。
当用户通过以下方式纠正 AI 的编码错误时，必须立即触发：
每次开始编写或修改代码前，必须先检查项目中是否存在 docs/coding-violations.md，如存在则先读取，避免重犯已登记的错误。
flowchart TD
A(["用户纠正了编码错误"]) --> B{"docs/coding-violations.md\n存在?"}
B -->|否| C["创建文件，写入表头"]
B -->|是| D["读取已有记录"]
C --> E["追加本次违规记录"]
D --> F{"相同类型违规\n是否已登记?"}
F -->|是| G["更新已有条目的发生次数"]
F -->|否| E
E --> H(["告知用户已登记"])
G --> H
docs/coding-violations.md
# 编码违规记录
> 本文件由 `coding-violation-log` Skill 自动维护。
> AI 编码前必须读取本文件，避免重犯已记录的错误。
| # | 类型 | 违规描述 | 正确做法 | 涉及文件 | 首次发生 | 次数 |
|---|------|---------|---------|---------|---------|------|
| 1 | 分层依赖 | Application 层直接引用 Infrastructure 层类 | 在 Domain 层定义接口，Infrastructure 层实现，Application 层依赖接口 | ScanNode.java | 2026-04-12 | 1 |
| 字段 | 说明 |
|---|---|
| 类型 | 违规分类：分层依赖 / 命名规范 / 异常处理 / 架构约束 / 代码风格 / 其他 |
| 违规描述 | 一句话描述做错了什么 |
| 正确做法 | 一句话描述应该怎么做 |
| 涉及文件 | 发生违规的文件名（不含完整路径） |
| 首次发生 | 首次登记日期（YYYY-MM-DD） |
| 次数 | 累计发生次数，重犯时 +1 |
每次开始编写代码时，按以下步骤执行：
docs/coding-violations.md 是否存在| Skill | 关系 |
|---|---|
java-coding-standards | 互补。java-coding-standards 是通用规范（阿里黄山版），本 Skill 登记项目级的具体违规 |
pre-implementation-code-orientation | 本 Skill 的"编码前回顾"应在 pre-implementation-code-orientation 之后、实际编码之前执行 |
| 错误做法 | 正确做法 |
|---|---|
| 用户纠正后只改代码不登记 | 改代码的同时必须追加违规记录 |
| 只在用户明确说"记一下"时才登记 | 只要用户纠正了写法就必须登记，不等显式指令 |
| 登记时写大段描述 | 违规描述和正确做法各一句话，简洁明确 |
| 每次编码前跳过回顾 | 存在 coding-violations.md 就必须读取 |
| 重犯已登记的错误 | 编码前回顾记录，特别注意相关模块的历史违规 |