Use to mine ../airlineops for governance habits gzkit lacks; produces a parity scan report (gzkit leads, AirlineOps adopts).
中文简介正在准备中。当前显示原文说明。
tvproductions/gzkit92026年10月21日 更新
免费在 GitHub 公开
gz-complexity-guide
Use when the operator asks for an authoring-time complexity hint or a complexity guide preview before commit.
中文简介正在准备中。当前显示原文说明。
查看安装方法包含的文件（1）
- SKILL.md3.3 KB
SKILL.md（原文）
安装前可以查看交给 AI 代理的指令内容。
gz-complexity-guide
Run gz complexity guide, the authoring-time hint surface of the
complexity-doctrine cluster (ADR-0.0.27 corpus, 0.0.28 thresholds, 0.0.29
advisor, 0.0.30 authoring guidance). It measures per-function radon_cc and
reports only the functions in the advise band of
.gzkit/rules/complexity-thresholds.json, the band below warn, so a refactor
decision lands while the code is being written. It never blocks: it exits 0
whatever it finds, and exits 1 only on a user error such as a missing path.
This skill ends at the hints. It does not refactor.
When to Use
The guide is the first-stop authoring surface for complexity hints:
- Authoring-time review — preview hints for a file or directory while editing it.
- Before a commit — catch functions growing toward
warn.
A function already at warn or block produces no hint here; use
gz-complexity-advisor for it.
uv run gz complexity guide src/gzkit/commands/validate_cmd.py
uv run gz complexity guide src/gzkit/ --json
A path is required unless --server is given. --server starts a
JSON-over-stdio server for editors (Content-Length framing; initialize,
analyze with a file_path, shutdown), whose envelope is
src/gzkit/schemas/authoring_guide_protocol.json.
Output Contract
Declared form: in-line hint prose (default human-readable). Each hint is a
block headed ── <file>:<start>-<end> ── with four lines:
- Archetype — the refactor archetype name
- Band —
approaching, orapproaching_warnin the upper half of the advise band - Guidance — the doctrinal-frame headline
- Move — the recommended-move excerpt
The line range is the diagnosed function's full span. No archetype rule in
data/advisor_archetype_rules.json covers the advise band, so every hint's
archetype is unclassified, and its guidance and move are the metric's general
ones.
Machine-readable mode: --json emits an array of AuthoringHint objects
with metric, precedence_band, crossing_value, archetype,
doctrinal_frame_headline, recommended_move, file_path, start_line and
end_line.
Trigger-Time vs. Authoring-Time
| Surface | Skill | Bands reported | Blocks? |
|---|---|---|---|
| Authoring-time hints | gz-complexity-guide (this skill) | advise | Never |
| Trigger-time diagnosis | gz-complexity-advisor | advise, warn, block | Exits 3 on block |
Both are run by hand in this repository; the advisor's auto-chain pre-commit hook is not installed.
Related
- Sister skill:
.gzkit/skills/gz-complexity-advisor/SKILL.md(ADR-0.0.29) - Manpage:
docs/user/manpages/complexity-guide.md - Runbook:
docs/user/runbook.md§ Governance Doctrine Surfaces - Parent ADR:
docs/design/adr/foundation/ADR-0.0.30-complexity-authoring-guidance/ - Threshold table:
.gzkit/rules/complexity-thresholds.json(ADR-0.0.28)
评价
还没有评价。欢迎分享你的使用感受。
评论
无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。
同一仓库的技能
Use to file a GitHub issue when a finding needs its own work order or the operator asks; OBPI corrections stay in its change log.
中文简介正在准备中。当前显示原文说明。
tvproductions/gzkit92026年10月21日 更新
Use to do the work a GHI describes, verify it and close the issue with evidence in one sweep.
中文简介正在准备中。当前显示原文说明。
tvproductions/gzkit92026年10月21日 更新
Use to triage the open GHI queue before planning or choosing what to pull; produces a ranked deliverable.
中文简介正在准备中。当前显示原文说明。
tvproductions/gzkit92026年10月21日 更新
git-sync
免费Run the guarded repository sync ritual; commit-time hooks enforce the cheap gates and the pre-push hook runs gz check.
中文简介正在准备中。当前显示原文说明。
tvproductions/gzkit92026年10月21日 更新
git-sync
免费Run the guarded repository sync ritual; the hooks your pre-commit config declares enforce the quality gates.
中文简介正在准备中。当前显示原文说明。
tvproductions/gzkit92026年10月21日 更新