zk-steward
Org role guidance for a ZK steward: engineer zero-knowledge proof systems with circuit design, SNARK vs STARK choice and security review. This is zero-knowledge cryptography, not Zettelkasten note-taking.
- License 许可
- Apache-2.0
- 所属仓库
- monoes/monomind
- 最近更新
- 2026-11-10
- Stars
- ★ 23
- Forks
- 2
01 前言 Front Matter
- name
- zk-steward
- tags
- [ "engineering", "security", "blockchain" ]
- tools
- [ "monograph_query", "monograph_context", "monograph_impact" ]
- source
- https://github.com/monoes/monomind
- license
- Apache-2.0
- description
- Org role guidance for a ZK steward: engineer zero-knowledge proof systems with circuit design, SNARK vs STARK choice and security review. This is zero-knowledge cryptography, not Zettelkasten note-taking.
03 SKILL.md 正文
ZK Steward — Best Practices
Focus
Engineers zero-knowledge proof systems — circuit design, protocol selection, and security review — for privacy-preserving and scalable smart-contract applications. (Note: despite the "ZK" name overlap with Zettelkasten note-taking tools, this role is zero-knowledge cryptography.)
Best practices
- Choose the proving system by threat model, not popularity: zk-SNARKs (Groth16/PLONK) need a trusted setup ceremony but give small proofs; zk-STARKs are transparent (no trusted setup) but produce larger proofs.
- Specify and test circuits fully before building the smart-contract layer on top — circuit rework after the contract layer is expensive.
- Get proving/verification UX (latency, proof size, gas cost of on-chain verification) right before shipping — adoption dies if proving is too slow or verification too expensive.
- Treat every circuit constraint as a potential under-constraint bug: an attacker who can satisfy the constraints with an invalid witness breaks soundness.
- Keep the witness generation and circuit logic in lockstep — a mismatch silently produces unprovable or incorrect proofs.
- Document trust assumptions explicitly: what the trusted setup ceremony assumed, what the verifier trusts, what stays off-chain.
- Match circuit language to target: Circom for Groth16/PLONK pipelines, Noir (Rust-like, Aztec) for general-purpose privacy circuits, Cairo for StarkNet/STARK systems.
Common pitfalls
- Under-constrained circuits — missing a constraint lets a malicious prover generate a valid proof for an invalid statement.
- Reusing trusted-setup parameters across unrelated circuits, silently breaking the ceremony's security guarantees.
- Treating "audited circuit language" as equivalent to "audited circuit" — the language's soundness doesn't cover application-level logic bugs.
- Ignoring proof malleability or replay risk when proofs are used as authorization tokens on-chain.
- Skipping formal specification of what the circuit is supposed to prove, making review essentially impossible.
Tools & techniques
- Circuit fuzzing frameworks (e.g. zkFuzz-style approaches) to catch under-constrained signals before deployment.
- Formal circuit specification and equivalence checking against a reference implementation.
- Groth16/PLONK for succinct on-chain verification cost; STARKs when transparency (no ceremony) matters more than proof size.
- Property-based testing across the full witness space, not just happy-path inputs.
- Independent security review of both circuit constraints and the surrounding smart-contract/verifier integration — these are separate attack surfaces.
04 同仓库更多 Skills
writing-plans
Use when you have a spec or requirements for a multi-step coding task and must write an implementation plan before touching code. Produces bite-sized TDD tasks with exact file paths, code and commands for an engineer with zero context.
write-spec
Write a feature spec or PRD from a problem statement or feature idea. Use when turning a vague idea or user request into a structured document, scoping a feature with goals and non-goals, defining success metrics and acceptance criteria, or breaking a big ask into a phased spec.
write-query
Write optimized SQL for your dialect with best practices. Use when translating a natural-language data need into SQL, building a multi-CTE query with joins and aggregations, optimizing a query against a large partitioned table, or getting dialect-specific syntax for Snowflake, BigQuery, Postgres, etc.
workflow-automation
Org role guidance for workflow automation: build and maintain CI/CD definitions in GitHub Actions or equivalent: triggers, jobs, matrices, caching. Covers path filters, dependency caching, parallel jobs, timeouts and fail-fast ordering.
workflow-architect
Org role guidance for a workflow architect: map full workflow trees for systems, user journeys and agents, covering every branch and failure. Covers discovering workflows from code, handoff contracts, timeouts, recovery paths and observable state.
worker-specialist
Org role guidance for a worker specialist: execute one assigned, well-scoped task with precision and report status honestly at real milestones. Covers confirming done-criteria first, surfacing blockers immediately and sharing intermediate results with peers.