메뉴
当用户主动纠正 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 就必须读取 |
| 重犯已登记的错误 | 编码前回顾记录，特别注意相关模块的历史违规 |