AGENT SKILL
file-header-guardian
文件头三行契约注释。触发:create file、新建文件、编写代码。
- License 许可
- MIT
- 最近更新
- 2026-06-24
- Stars
- ★ 66
- Forks
- 24
01 前言 Front Matter
- name
- file-header-guardian
- description
- 文件头三行契约注释。触发:create file、新建文件、编写代码。
02 资源文件 68
- 参考文档checklist.md12.2 KB
- 其他customize.toml1.5 KB
- 参考文档instructions.md1.1 KB
- 参考文档resources/knowledge/adr-quality-readiness-checklist.md24.8 KB
- 参考文档resources/knowledge/api-request.md16.7 KB
- 参考文档resources/knowledge/api-testing-patterns.md26.3 KB
- 参考文档resources/knowledge/auth-session.md15.8 KB
- 参考文档resources/knowledge/burn-in.md6.4 KB
- 参考文档resources/knowledge/ci-burn-in.md22.0 KB
- 参考文档resources/knowledge/component-tdd.md15.8 KB
- 参考文档resources/knowledge/contract-testing.md38.1 KB
- 参考文档resources/knowledge/data-factories.md15.0 KB
- 参考文档resources/knowledge/email-auth.md24.0 KB
- 参考文档resources/knowledge/error-handling.md22.4 KB
- 参考文档resources/knowledge/feature-flags.md22.7 KB
- 参考文档resources/knowledge/file-utils.md13.4 KB
- 参考文档resources/knowledge/fixture-architecture.md12.1 KB
- 参考文档resources/knowledge/fixtures-composition.md11.0 KB
- 参考文档resources/knowledge/intercept-network-call.md13.2 KB
- 参考文档resources/knowledge/log.md11.0 KB
- 参考文档resources/knowledge/network-error-monitor.md12.0 KB
- 参考文档resources/knowledge/network-first.md15.9 KB
- 参考文档resources/knowledge/network-recorder.md15.1 KB
- 参考文档resources/knowledge/nfr-criteria.md26.0 KB
- 参考文档resources/knowledge/overview.md9.4 KB
- 参考文档resources/knowledge/pact-broker-webhooks.md13.1 KB
- 参考文档resources/knowledge/pact-consumer-di.md11.7 KB
- 参考文档resources/knowledge/pact-consumer-framework-setup.md35.0 KB
- 参考文档resources/knowledge/pact-mcp.md8.8 KB
- 参考文档resources/knowledge/pactjs-utils-consumer-helpers.md15.7 KB
- 参考文档resources/knowledge/pactjs-utils-overview.md10.2 KB
- 参考文档resources/knowledge/pactjs-utils-provider-verifier.md17.8 KB
- 参考文档resources/knowledge/pactjs-utils-request-filter.md7.1 KB
- 参考文档resources/knowledge/playwright-cli.md14.6 KB
- 参考文档resources/knowledge/playwright-config.md21.0 KB
- 参考文档resources/knowledge/probability-impact.md18.8 KB
- 参考文档resources/knowledge/recurse.md12.6 KB
- 参考文档resources/knowledge/risk-governance.md20.5 KB
- 参考文档resources/knowledge/selective-testing.md21.3 KB
- 参考文档resources/knowledge/selector-resilience.md19.3 KB
- 参考文档resources/knowledge/test-healing-patterns.md20.9 KB
- 参考文档resources/knowledge/test-levels-framework.md14.4 KB
- 参考文档resources/knowledge/test-priorities-matrix.md11.2 KB
- 参考文档resources/knowledge/test-quality.md24.0 KB
- 参考文档resources/knowledge/timing-debugging.md13.7 KB
- 参考文档resources/knowledge/visual-debugging.md17.1 KB
- 参考文档resources/knowledge/webhook-module-setup.md5.7 KB
- 参考文档resources/knowledge/webhook-providers.md6.3 KB
- 参考文档resources/knowledge/webhook-risk-guidance.md6.3 KB
- 参考文档resources/knowledge/webhook-template-matchers.md5.9 KB
- 参考文档resources/knowledge/webhook-testing-fundamentals.md3.1 KB
- 参考文档resources/knowledge/webhook-timeout-error.md5.6 KB
- 参考文档resources/knowledge/webhook-waiting-querying.md6.9 KB
- 资产文件resources/tea-index.csv10.7 KB
- 参考文档skill-report.json8.9 KB
- 参考文档steps-c/step-01-preflight.md4.0 KB
- 参考文档steps-c/step-01b-resume.md3.7 KB
- 参考文档steps-c/step-02-select-framework.md2.9 KB
- 参考文档steps-c/step-03-scaffold-framework.md14.2 KB
- 参考文档steps-c/step-04-docs-and-scripts.md3.0 KB
- 参考文档steps-c/step-05-validate-and-summary.md2.4 KB
- 参考文档steps-e/step-01-assess.md1.2 KB
- 参考文档steps-e/step-02-apply-edit.md1.4 KB
- 参考文档steps-v/step-01-validate.md1.8 KB
- 参考文档validation-report-20260127-095021.md2.0 KB
- 参考文档validation-report-20260127-102401.md3.7 KB
- 参考文档workflow-plan.md519 B
- 参考文档workflow.yaml1.7 KB
03 SKILL.md 正文
文件头注释守护者
触发:创建代码文件,修改文件后检查头注释准确性。
模板
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 管目录。