Agent Skillsboshu2/agentops › standards

standards

GitHub

该技能用于根据变更文件、语言和风险精准加载相关工程标准,对比代码并输出带路径行号的合规发现。新增代码编写时的内联规范及批量修改的安全审计标准。

images/gemini/skills/standards/SKILL.md boshu2/agentops

Trigger Scenarios

check standards which standards apply

Install

npx skills add boshu2/agentops --skill standards -g -y
More Options

Non-standard path

npx skills add https://github.com/boshu2/agentops/tree/main/images/gemini/skills/standards -g -y

Use without installing

npx skills use boshu2/agentops@standards

指定 Agent (Claude Code)

npx skills add boshu2/agentops --skill standards -a claude-code -g -y

安装 repo 全部 skill

npx skills add boshu2/agentops --all -g -y

预览 repo 内 skill

npx skills add boshu2/agentops --list

SKILL.md

Frontmatter
{
    "name": "standards",
    "consumes": [],
    "metadata": {
        "tier": "knowledge",
        "effects": [],
        "disposition": "keep_specialist",
        "capabilities": [
            "standards"
        ],
        "dependencies": [],
        "canonical_status": "canonical"
    },
    "produces": [
        "stdout"
    ],
    "practices": [
        "pragmatic-programmer",
        "clean-code"
    ],
    "context_rel": [],
    "description": "Load only the standards relevant to a caller-supplied change, then report concrete findings. Triggers: \"check standards\", \"which standards apply\".",
    "hexagonal_role": "supporting",
    "output_contract": "cited standards and factual findings",
    "skill_api_version": 1
}

Standards — focused engineering guidance

Load the smallest set of standards justified by the caller's files, language, and risks. Do not preload the entire reference corpus.

Prompt

Check standards for the changed files in fleet-router PR #214: cli/internal/auth/token.go and cli/internal/auth/token_test.go, Go, a security-sensitive change. Load only the matching references and report cited findings with path and line plus checked and not-checked scope.

It's working if

  • The report loads common-standards.md plus only the matching Go reference, never the full reference corpus.
  • Every finding cites a path and line, e.g. cli/internal/auth/token.go:18.
  • The response discloses checked and not_checked scope explicitly, even when not_checked is empty.
  • git diff --stat shows no test, gate, or fixture file changed; standards reports findings only.

Procedure

  1. Record the supplied paths, language, change type, and risk cues.
  2. Load common-standards.md plus only the matching language or checklist references.
  3. Compare the supplied artifact to those sources.
  4. Return cited findings with path and line when possible, plus checked and not-checked scope.
  5. Stop.

This skill provides context and findings. It does not edit, validate, retry, approve, commit, release, deliver, or decide continuation.

Load-bearing conventions for produced code (MEASURED)

When the caller is about to WRITE code (not only review it), surface the matching language rules INLINE in the working context — a behind-the-link reference does not change behavior; an inline imperative does. The Go core:

  • Wrap every propagated error with context: fmt.Errorf("doing X: %w", err) — never return a bare inner error.
  • Multi-case functions get TABLE-DRIVEN tests ([]struct cases + t.Run per case), asserting exact expected values including the error cases.

For other languages, pull the matching reference below and inline its top rules the same way.

Measured 2026-08-04, probe standards-go-conventions (gpt-5.6-luna, N=2, directional): control produced the %w-wrapped + table-driven shape in 1/2 runs; with these rules inline, 2/2. Inline-imperative beats reference-link — the graphify probe measured a linked doc instruction obeyed 0/2. Ledger: evals/skill-probes/LEDGER.md.

Mutation-safety standards

When the supplied change rewrites existing files in bulk — formatters, codemods, migration scripts, generators pointed at hand-written sources — check it against three standards and report each as a finding when absent:

  • Single audited mutation chokepoint. All rewrites flow through one named command or script whose inputs, outputs, and dry-run mode can be inspected. Edits scattered across ad-hoc one-liners and manual touch-ups are the diffuse mutation failure mode: no single point can be audited, re-run, or blamed. Finding: name every mutation path outside the chokepoint.
  • Hash-witnessed backups before rewrite. Before the chokepoint runs, the originals are preserved with content hashes recorded (a committed baseline counts), so "the rewrite changed only what it claims" is checkable byte-for-byte, not asserted. Finding: a bulk rewrite with no verifiable before-state.
  • Self-administered ambition gate. The change states what it deliberately does not touch, and the diff respects it. A formatter run that also renames, a codemod that also refactors, is the scope-creep rewrite failure mode. Finding: any file class in the diff outside the change's own stated scope.

Stop condition for this check: all three standards have an explicit pass or finding; a bulk-rewrite review that reports style nits but skips these is incomplete.

References

Version History

  • 8061085 Current 2026-09-09 05:17

    新增代码编写内联规范与批量修改的突变安全审计标准,增加触发场景示例。

  • 7b07a7d 2026-08-19 22:00

    新增基于评估实验的测量数据块,强化Go语言错误包装和表格驱动测试的内联指令,以验证行为改进效果。

  • 3f402e5 2026-07-24 22:08

Same Skill Collection

images/gemini/skills/account-rotation/SKILL.md
images/gemini/skills/agent-mail/SKILL.md
images/gemini/skills/agent-native/SKILL.md
images/gemini/skills/agy-native/SKILL.md
images/gemini/skills/anti-ceremony/SKILL.md
images/gemini/skills/automation-shape-routing/SKILL.md
images/gemini/skills/bootstrap/SKILL.md
images/gemini/skills/cass/SKILL.md
images/gemini/skills/cc-hooks/SKILL.md
images/gemini/skills/codebase-recon/SKILL.md
images/gemini/skills/codex-exec/SKILL.md
images/gemini/skills/converter/SKILL.md
images/gemini/skills/council/SKILL.md
images/gemini/skills/craft-goal/SKILL.md
images/gemini/skills/crank/SKILL.md
images/gemini/skills/dcg/SKILL.md
images/gemini/skills/doc/SKILL.md
images/gemini/skills/domain/SKILL.md
images/gemini/skills/fitness/SKILL.md
images/gemini/skills/goals/SKILL.md
images/gemini/skills/handoff/SKILL.md
images/gemini/skills/human-only-skills/SKILL.md
images/gemini/skills/idea-genie/SKILL.md
images/gemini/skills/implement/SKILL.md
images/gemini/skills/learn/SKILL.md
images/gemini/skills/ms/SKILL.md
images/gemini/skills/ntm/SKILL.md
images/gemini/skills/one-way-door/SKILL.md
images/gemini/skills/operationalize/SKILL.md
images/gemini/skills/pattern-mining/SKILL.md
images/gemini/skills/plan/SKILL.md
images/gemini/skills/postmortem/SKILL.md
images/gemini/skills/premortem/SKILL.md
images/gemini/skills/product/SKILL.md
images/gemini/skills/rch/SKILL.md
images/gemini/skills/reality-check/SKILL.md
images/gemini/skills/refactor/SKILL.md
images/gemini/skills/research/SKILL.md
images/gemini/skills/reverse-engineer/SKILL.md
images/gemini/skills/route/SKILL.md
images/gemini/skills/rpi/SKILL.md
images/gemini/skills/sbh/SKILL.md
images/gemini/skills/scaffold/SKILL.md
images/gemini/skills/scope/SKILL.md
images/gemini/skills/security/SKILL.md
images/gemini/skills/shared/SKILL.md
images/gemini/skills/skill-builder/SKILL.md
images/gemini/skills/skill-eval/SKILL.md
images/gemini/skills/status/SKILL.md

Metadata

Files
0
Version
8061085
Hash
3baaa208
Indexed
2026-07-24 22:08

Home - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-09-16 01:34
浙ICP备14020137号-1 $Map of visitor$