360 Secure SkillHub
360 安全技能中心

Annotate

该 Skill 是一个注解速查参考,通过 scripts/script.sh 的子命令输出类型注解、JSDoc/docstring、装饰器、数据标注、git blame 注解、注解标准与最佳实践等说明文本;本身不执行代码分析、不生成或修改代码,也不实际执行 git 操作。

bytesagain
bytesagain
热度 22.28
最近更新 2026-03-22 00:36:48
分类:知识依赖:代码执行应用场景:概念解释 / 代码审查

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add annotate
Metadata
name
annotate
version
1.0.0
description
Code and data annotation reference — type annotations, JSDoc/docstrings, data labeling for ML, and git blame annotation. Use when documenting code, adding type hints, labeling datasets, or tracing code history.
author
BytesAgain
homepage
https://bytesagain.com
source
https://github.com/bytesagain/ai-skills
tags
["annotate","documentation","types","jsdoc","docstring","labeling","devtools"]
category
devtools

Annotate — Annotation Reference

Quick-reference skill for code annotation, type hints, documentation strings, and data labeling.

When to Use

  • Adding type annotations to Python, TypeScript, or Java code
  • Writing JSDoc, docstrings, or Javadoc documentation
  • Labeling datasets for machine learning training
  • Using git annotate/blame for code archaeology
  • Understanding decorator/annotation patterns in frameworks

Commands

intro

scripts/script.sh intro

Overview of annotation types — code, data, and metadata annotations.

types

scripts/script.sh types

Type annotations — Python type hints, TypeScript types, Java generics.

docstrings

scripts/script.sh docstrings

Documentation annotations — JSDoc, Python docstrings, Javadoc, XML comments.

decorators

scripts/script.sh decorators

Decorator/annotation patterns — Python decorators, Java annotations, TypeScript decorators.

labeling

scripts/script.sh labeling

Data labeling for ML — annotation types, tools, quality control, and formats.

git

scripts/script.sh git

Git annotation — blame, annotate, log, and code archaeology techniques.

standards

scripts/script.sh standards

Annotation standards — OpenAPI, JSON Schema, GraphQL descriptions, YAML comments.

best

scripts/script.sh best

Annotation best practices — when to annotate, what to skip, and maintenance.

help

scripts/script.sh help

version

scripts/script.sh version

Configuration

Variable Description
ANNOTATE_DIR Data directory (default: ~/.annotate/)

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com