菜单
Use when you say `run taste lints`, `check file size`, or `lint taste invariants`. Custom lints with agent-readable remediation instructions for file size, naming conventions, structured logging, and complexity.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/rjmurillo/ai-agents --skill taste-lints命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
基于 SOC 职业分类
| name | taste-lints |
| version | 1.0.0 |
| description | Use when you say `run taste lints`, `check file size`, or `lint taste invariants`. Custom lints with agent-readable remediation instructions for file size, naming conventions, structured logging, and complexity. |
| license | MIT |
Custom lints where error messages become agent-readable remediation instructions.
Inspired by OpenAI Harness Engineering:
"We statically enforce structured logging, naming conventions for schemas and types, file size limits, and platform-specific reliability requirements with custom lints. Because the lints are custom, we write the error messages to inject remediation instructions into agent context."
| Trigger Phrase | Operation |
|---|---|
run taste lints | taste_lints.py on staged or specified files |
check file size | taste_lints.py with file-size rule only |
check naming conventions | taste_lints.py with naming rule only |
lint taste invariants | taste_lints.py full scan |
taste lint report | taste_lints.py with JSON output |
Use this skill when:
Files exceeding line thresholds indicate poor cohesion.
| Threshold | Lines | Severity |
|---|---|---|
| Warning | 301-500 | warning |
| Error | 501+ | error |
| Pattern | Rule | Applies To |
|---|---|---|
snake_case | Python files, functions, variables | *.py |
kebab-case | Skill directories, YAML files | .claude/skills/, *.yml |
PascalCase | PowerShell functions, classes | *.ps1, *.psm1 |
UPPER_CASE | Constants, environment variables | All languages |
invoke_ prefix | Hook scripts | .claude/hooks/ |
Functions exceeding cyclomatic complexity 10 need decomposition.
Skills exceeding 500 lines need progressive disclosure refactoring.
python3 .claude/skills/taste-lints/scripts/taste_lints.py with target files| Script | Platform | Usage |
|---|---|---|
scripts/taste_lints.py | Python 3.11+ | Scan staged files, diff scopes, directories, or explicit files for taste invariant violations |
# Scan staged files
python3 .claude/skills/taste-lints/scripts/taste_lints.py --git-staged
# Scope to a pull request diff (only files changed vs the base branch)
python3 .claude/skills/taste-lints/scripts/taste_lints.py --diff-scope "origin/$BASE_BRANCH"
# Scan specific files
python3 .claude/skills/taste-lints/scripts/taste_lints.py path/to/file.py
# Scan a directory
python3 .claude/skills/taste-lints/scripts/taste_lints.py --directory src/
# JSON output
python3 .claude/skills/taste-lints/scripts/taste_lints.py --format json --git-staged
# Run specific rules only
python3 .claude/skills/taste-lints/scripts/taste_lints.py --rules file-size,naming
| Code | Meaning |
|---|---|
| 0 | No violations found |
| 1 | Script error (bad arguments, file not found) |
| 10 | Violations detected |
After execution:
--format json is usedAdd a comment to suppress a specific rule on a file:
# taste-lint: ignore file-size
Valid rules: file-size, naming, complexity, skill-size
Define what to build. Transform a problem into testable requirements with acceptance criteria.
Validate and complete session logs before commit. Auto-populates session end evidence (commit SHA, lint results, memory updates) and runs validation. Use when finishing a session, before committing, or when session validation fails. Do NOT use to create a new session log (use session-init) or to repair a session protocol failure reported by CI (use session-log-fixer).
Create protocol-compliant JSON session logs with verification-based enforcement. Autonomous operation with auto-incremented session numbers and objective derivation from git state. Use when starting any new session. Use when you say "start a session", "create the session log". Do NOT use for mid-session protocol checks (use session), or to complete and validate a log at the end of a session (use session-end).