zhtw-mcp: Skill for Claude Code

zhtw-mcp conventions

The gate settles formatting and correctness. cargo fmt, clippy, black, shellcheck and scripts/indent.sh run in make check, so none of that is here. What is here is what a reviewer would otherwise have to say out loud, plus the rules enforced by the git hooks rather than by CI: the commit message and the staged-content checks. Any cargo build installs them, through build.rs; make hooks installs them on their own.

README.md and CLAUDE.md are the tracked and local halves respectively, and this file does not restate either. Where two of them speak to the same thing, README.md wins.

Commit messages

The house style is Chris Beams' seven rules, and scripts/git-commit-msg.sh enforces the mechanical ones: subject within 50 columns, capitalized, imperative, no trailing period, no backticks, no conventional-commit type prefix, body wrapped at 72 columns, no em dash character, no tabs, and no control or bidirectional-override characters. An area prefix such as Windows: retry the replace is not a conventional-commit prefix and is allowed. Run git log --no-merges --format=%s if you want the calibration set rather than the claim; the log sits at 43 columns in the median.

Two of those rules are this project's rather than Beams'. Widths are counted in terminal columns, so a CJK character costs two, which is what git log --oneline has to fit. And the subject line is English prose that may quote a Chinese term, which is what every subject in this log already is:

Narrow 聯繫 cross_strait flagging to contact-copy
Add word "test" to negative_context_clues for pass rule
Take the binary under test from cargo

The rule the hook cannot check is what the body says. This tree keeps its detailed reasoning in the comment next to the code, often several paragraphs per decision. A body that retells the mechanics duplicates that comment and then goes stale on its own. Write the premise and the trade, once, usually a single paragraph. Backticks are fine there and not in the subject.