AgentSkillsCN

ascii-scanner

强制实施全工作区范围内的纯 ASCII（0x00–0x7F）合规性，以确保跨平台兼容性和仓库的整洁规范。

SKILL.md
--- frontmatter
name: ascii-scanner
description: Enforces workspace-wide ASCII-only (0x00-0x7F) compliance to ensure cross-platform compatibility and repository hygiene.
compatibility: opencode
metadata:
  version: "1.0"
  impact: High (Policy Enforcement)
  tags: ["compliance", "validation", "lint", "ascii"]

Skill: ascii-scanner

Description

An automated validation tool to enforce the workspace-wide ASCII-only policy (0x00-0x7F). It identifies non-ASCII characters, emojis, and smart quotes that violate the "Global Constitution."

When to Use

  • •Pre-Commit: Before staging any changes in repo/.
  • •After Reporting: After generating ticket/*/analysis_report.md.
  • •CI/CD Simulation: Whenever an Agent completes a multi-file refactoring task.

Usage

Execute from the workspace root. Uses defensive prelude: default dry-run; use --execute to run. Supports --json-log, --no-color, --force (unused), --dry-run.

To maximize efficiency, avoid scanning the entire repository; target only specific files or staged changes.

bash
# Repo paths (changed files only)
# Scan only changed/new files under repo/<repo-name>/, excluding vendor/ and common generated paths.
git -C "repo/<repo-name>" diff --diff-filter=ACM --name-only HEAD \
  | grep -Ev '^(vendor/|generated/|dist/|zz_generated\.)' \
  | xargs -r -I {} bash .opencode/skills/ascii-scanner/ascii_scanner.sh "repo/<repo-name>/{}"

# Non-repo paths
# Scan the target files directly (no git diff).
bash .opencode/skills/ascii-scanner/ascii_scanner.sh <file_path_1> <file_path_2>

# Recommended: Scan only staged files in a repo
git -C "repo/<repo-name>" diff --cached --name-only \
  | xargs -r -I {} bash .opencode/skills/ascii-scanner/ascii_scanner.sh "repo/<repo-name>/{}"

Expected Outcomes

  • •Success (Exit 0): Confirms all files are ASCII compliant.
  • •Failure (Exit 1): Returns a list of violations with file paths, line numbers, and the offending content.