Marketplace file-header-guardian

文件头三行契约注释。触发：create file、新建文件、编写代码。

install

source · Clone the upstream repo

git clone https://github.com/aiskillstore/marketplace

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/aiskillstore/marketplace "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/dimon94/file-header-guardian" ~/.claude/skills/aiskillstore-marketplace-file-header-guardian && rm -rf "$T"

manifest: skills/dimon94/file-header-guardian/SKILL.md

source content

文件头注释守护者

触发：创建代码文件，修改文件后检查头注释准确性。

模板

TS/JS:

/**
 * @input  依赖什么
 * @output 提供什么
 * @pos    系统地位
 * ⚠️ 修改后同步：文件头 + 目录 CLAUDE.md
 */

Python:

"""
@input  依赖什么
@output 提供什么
@pos    系统地位
⚠️ 修改后同步：文件头 + 目录 CLAUDE.md
"""

Shell:

# @input  依赖什么
# @output 提供什么
# @pos    系统地位
# ⚠️ 修改后同步：文件头 + 目录 CLAUDE.md

示例

/**
 * @input  prisma.service 数据库连接
 * @output UserService: create/update/delete
 * @pos    用户模块核心
 * ⚠️ 修改后同步：文件头 + 目录 CLAUDE.md
 */
export class UserService { }

豁免

配置文件（json/yaml）、样式（css）、生成文件（*.d.ts）、node_modules。

协作：本 skill 管文件，fractal-docs-generator 管目录。