该技能用于在修改代码时留下结构化笔记、注释与标注，核心目标是给未来的 AI 助手和人类开发者保留上下文。
主要能力与格式：AI-DEV-NOTE 用于 AI 间沟通，解释非显而易见的实现决策、记录被否决的备选方案、关联 PR/issue、提示隐藏缺陷；结构化 TODO(ai/<category>)，常见类别有 refactor、performance、security、accessibility、testing、docs、context、edge-case，需写明补充上下文、备选方案、阻塞项、影响与优先级；DECISION 记录用于权衡库或模式、性能取舍、架构与安全决策；CONTEXT 用于解释看似奇怪的临时方案；AI-UNCERTAIN 用于标记不确定、建议人工复核之处。
放置与密度：笔记应紧贴所描述的代码，文件级放在导入之后，函数级放在函数前，行内放在相关代码上一行；避免逐行注释明显的代码，也避免模糊、无行动信息的笔记，不重复 commit message 已有的内容。
维护：临时笔记或变通方案可标注 REMOVE_AFTER、REPLACE_WHEN 等过期条件；修改带旧笔记的代码时保留原始笔记并标注更新日期。协作中可用 grep 提取笔记，例如 grep -r "AI-DEV-NOTE" src/、grep -r "TODO(ai/" src/、grep -r "AI-UNCERTAIN" src/。示例覆盖 TypeScript/JavaScript、Python、Go、Rust。
限制：资料未说明具体安装方式、收费、价格或平台要求；效果、规则强制程度与适用语言支持范围暂未提供。