AI 生成代码标识

它解决什么问题

AI 参与编写的代码落到仓库之后，通常和人工代码长得一模一样。code review、变更审计、合规扫描都很难判断某个类、某个方法、某段逻辑到底是人写的还是模型生成的。等到出问题再回溯，往往已经很难界定责任边界。

本技能提供的不是「给代码盖个章」的仪式感，而是一套可被机器校验的标注约定：AI 写入的代码都带固定标识字符串 --- @ty.aicoding@ ---，校验逻辑只需要查找这个子串，不需要解析复杂结构。

核心能力

技能把标注拆成三条规范，按改动粒度区分：

• 规范 1：新增文件 / 新增类。 AI 新增的类必须带文档注释，标识写在文档注释块内部，且位于最后一行、紧贴结束符 */ 之前。不允许在类定义上方单独飘一行标记。
• 规范 2：新增方法 / 函数。 与规范 1 同构：方法必须有文档注释，标识进注释块内部最后一行。
• 规范 3：新增 / 修改的代码块。 用成对注释包裹，一块代码一对开始/结束标记，不要逐行贴。

注释语法按语言适配

不能照搬某种语言的注释风格。技能按文件后缀分了五张表：C 风格（/** ... */）、井号风格（# 或 docstring）、标记/样式（<!-- ... -->）、样式表（/* ... */）、SQL（--）。Vue/Svelte 还要注意：<script> 内用 C 风格，<template> 内用 HTML 注释。

两个容易踩的坑

一是 XML 类文件。XML 规范禁止注释内容出现 --，所以 .xml、.html、.vue template、.svelte 里的标识必须去掉两侧破折号，写成 <!-- @ty.aicoding@ -->。hook 只校验子串，破折号并非必需。

二是重复标注。如果方法本身已经是 AI 写的、文档注释里已保留标识，那么在该方法体内增改代码就不需要再用规范 3 包裹——整个方法都已经是 AI 代码，体内改动天然属于这个范畴。规范 3 只服务于在非 AI 区域里插入代码的场景。

适用边界

标识只加注释，不改变代码逻辑。纯格式化、空白改动可以不打。配置和文档类文件（.md、.json 等）不在范围内，hook 会跳过。