🧭
QualityPython

Field Mapping Safety

by doccker

Field Mapping Safety is a Quality skill for Claude Code, published by doccker in cc-use-exp.

1K stars105 forkson doccker/cc-use-expAdded 2026/08/21Repository updated 2026/06/30
View source on GitHubDownload repo ZIP
antigravityclaude-codecodexcursorgemini-cligithub-copilot
Install in seconds
Install Field Mapping Safety
Copy Field Mapping Safety into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/doccker/cc-use-exp/tree/main/.antigravity/skills/field-mapping-safety ~/.claude/skills/field-mapping-safety

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/doccker/cc-use-exp.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
.antigravity/skills/field-mapping-safety/SKILL.md in doccker/cc-use-exp
Installs to
~/.claude/skills/field-mapping-safety
Collection
One of 23 skills cataloged from this repository
Category
Quality — 1354 skills

What Field Mapping Safety does

Field Mapping Safety helps prevent incorrect field-name guesses when refactoring table columns, enum mappings, and data transforms. Use it when similar fields or incomplete mappings could cause runtime blanks or Invalid Date issues.

Field Mapping Safety is cataloged under Quality on DirSkills. Field Mapping Safety comes from a repository tagged antigravity, claude-code, codex, cursor and gemini-cli.

Documentation

README

字段映射安全规范

触发场景

  • 重构表格列定义（dataIndex、columns）
  • 重构枚举类型映射（typeMap、statusMap）
  • 重构数据转换逻辑（render 函数、formatter）
  • 类型定义中有多个相似字段（changedAt vs createdAt）

核心原则

不要根据类型定义推测字段名，必须查看原始代码的实际使用

检查清单

1. 字段名验证

  • 查看原始代码的 dataIndex
  • 查看后端 API 返回的实际字段名
  • 优先使用必填字段，避免可选字段
  • 注意字段名的细微差异（changedAt vs createdAt、changeType vs operationType）

2. 枚举映射验证

  • 对照原始代码，逐个检查枚举值
  • 确保映射完整（不遗漏任何枚举值）
  • 检查枚举值的拼写（UPLOAD vs Upload）
  • 检查枚举值的颜色、文本是否一致

3. 运行时测试

  • TypeScript 类型检查通过（必要但不充分）
  • 在实际环境中测试功能
  • 检查是否显示 "Invalid Date"、"undefined"、空白
  • 检查枚举值是否都有对应的映射

常见陷阱

陷阱 1: 类型定义有歧义

场景：类型定义中有多个相似字段

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Field Mapping Safety

  • What else does doccker publish alongside Field Mapping Safety?

    Field Mapping Safety is one of 23 skills that DirSkills catalogs from doccker/cc-use-exp, the repository it ships in. Its siblings there include API Design Safety, Api Design Safety and Api Proxy Safety. Each one is a separate skill with its own page in this directory, installs the same way Field Mapping Safety does, and is maintained by doccker in that same repository. The rest of the collection is listed on the doccker/cc-use-exp page.

  • How does Field Mapping Safety compare to other Quality skills?

    Field Mapping Safety ranks #837 by stars among the 1354 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Field Mapping Safety against them. Open each page to compare what they document and how they install.

More from doccker/cc-use-exp

Field Mapping Safety is one of 23 skills cataloged on DirSkills from doccker/cc-use-exp.

See all 23 skills →
🛡️
1w ago

API Design Safety

API Design Safety helps you design REST API responses and generated outputs with consistent field semantics, null handling, and status codes. It also checks required fields before exporting files or sending downstream payloads to avoid silent failures.
Quality
1K105
🧩
1w ago

Api Design Safety

Api Design Safety helps prevent REST API response design mistakes such as field mix-ups, ambiguous return types, and inconsistent empty values. Use it when designing or changing API responses and handling returned data.
AI Engineering
1K105
🛡️
1w ago

Api Proxy Safety

Api Proxy Safety defines safe keyword matching for gateways, proxies, WAFs, and CDNs so normal content is not misclassified as an error. It is used when implementing heuristic checks for response bodies, status codes, and error schemas.
DevOps
1K105
⏳
1w ago

Async Task Pattern

Async Task Pattern provides a standard triggerAsync/getStatus flow for operations that may run longer than 10 seconds. Use it for batch processing, remote API fan-out, or scans that would otherwise time out or be triggered twice.
Automation
1K105
🐚
1w ago

Bash Style

Bash Style provides shell scripting and command-writing conventions for .sh files, Dockerfiles, Makefiles, YAML, and Markdown bash blocks. Use it to format commands, heredocs, file writes, permissions, and script safety.
Writing
1K105
🧩
1w ago

Code Quality Principles

Code Quality Principles provides a checklist for modular design, refactoring, and code review. Use it to assess module size, call depth, fan-in/fan-out, boundaries, scope cohesion, and predictability.
Quality
1K105

More Quality skills

Field Mapping Safety is one of 1354 Quality skills cataloged on DirSkills, ranked #837 by stars among them.

Browse all Quality skills →
⏱️
3w ago

Benchmark

Benchmark measures performance baselines, detects regressions before and after PRs, and compares stack alternatives for pages, APIs, and builds.
Quality
239.8K36.4K
⏱️
3w ago

Benchmark Optimization Loop

Benchmark Optimization Loop turns vague performance goals into a bounded, measured optimization process. Use it when asked to make something faster, benchmark latency/throughput/cost, or choose the best implementation by repeated measured tests.
Quality
239.8K36.4K
🔌
3w ago

API Design Patterns

API Design Patterns provides conventions and best practices for designing consistent REST APIs. Use it when creating endpoints, reviewing contracts, handling pagination, error responses, status codes, filtering, or versioning.
Quality
239.8K36.4K