一个用于 Grok Build 的插件,可在创建、重构、调试、修复、审查或展示 C11 代码时强制实行严格的机器可读性标准。

Stars

22

7 天增长

暂无数据

Fork 数

1

开放 Issue

1

开源协议

MIT

最近更新

2026-08-01

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它将一套详细且强约束的 C11“机器可读性”标准打包成可安装、可自动加载的 Grok 技能,具体覆盖文件布局、命名、函数分层、错误处理、循环边界和断言密度等规则。

适合谁使用

  • 使用 Grok Build 的 C 语言开发者
  • 需要统一 C11 代码规范的团队
  • 负责代码审查或质量门禁的工程师
  • 希望借助插件强制执行编码标准的 Grok 用户

典型使用场景

  • 开发时统一 C 文件布局和命名约定
  • 审查 C 代码中的有界循环、递归和裸字面量
  • 将旧 C 代码重构为 orchestrator、leaf、adapter 分层结构
  • 用状态枚举和 MODULE_TRY 统一错误处理风格

项目优势

  • 仓库内置完整的 18 节 C 规范文档
  • 在创建、修改或审查 C 文件时自动加载技能
  • 包含具体规则,如禁止裸字面量、禁止递归、要求断言密度
  • 提供 marketplace、one-shot 和本地克隆等多种安装方式

使用前须知

  • 依赖 Grok Build 插件环境才能运行
  • 标准仅针对 C11,不适用于其他语言
  • 规范严格且具有规范性,现有 C 代码可能需要较大重构才能符合

README 快速开始

write-legible-c

Grok Build plugin that enforces a strict C11 machine-legibility standard when creating, refactoring, debugging, fixing, reviewing, or presenting C code.

It ships one skill, /write-legible-c, plus the full normative standard in references/c-standard.md (file layout, naming, orchestrator/leaf/adapter split, status enums + MODULE_TRY, bounded loops, assertion density, section-16 near-miss refactors, and repository-level AGENTS.md rules).

Install (recommended)

Add this marketplace, then install the plugin:

grok plugin marketplace add 7etsuo/write-legible-c
grok plugin install write-legible-c --trust

Enable it if it shows as installed but inactive:

grok plugin enable write-legible-c

Or in the TUI: /plugins → Plugins tab → select write-legible-cSpace to enable → r to reload (or start a new session).

One-shot install from the plugin path

grok plugin install 7etsuo/write-legible-c#plugins/write-legible-c --trust

Local clone

git clone https://github.com/7etsuo/write-legible-c.git
grok plugin marketplace add ./write-legible-c
grok plugin install write-legible-c --trust

Use

  • Slash command: /write-legible-c
  • Skills menu: /skills write-legible-c
  • Auto: Grok loads the skill when you create, change, or review C (.c / .h)

What you get

plugins/write-legible-c/
  plugin.json
  skills/write-legible-c/
    SKILL.md
    references/c-standard.md   # full 18-section standard

Highlights from the standard:

  • Fixed file layout and greppable module prefixes
  • Status enums, boundary validation, MODULE_TRY only on non-acquiring paths
  • Orchestrator / leaf / adapter function altitudes
  • No naked literals (except obvious 0/1), named constants, designated inits
  • Bounded loops, no recursion, early returns, assert density on mutators
  • Section 16 near-miss diagnosis before accepting “already clean” C

Uninstall

grok plugin uninstall write-legible-c --confirm
# optional: drop the marketplace source
grok plugin marketplace remove 7etsuo/write-legible-c

Validate (maintainers)

grok plugin validate ./plugins/write-legible-c

License

MIT. The C standard text is part of this repository under the same license.

项目描述

Grok Build plugin: strict C11 machine-legibility standard for writing and reviewing C

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

MoonshotAI
精选
MoonshotAI GitHub avatar

Kimi-K3

Kimi K3 is an open-weight, 2.8T-parameter native multimodal agentic model with a 1M-token context window, designed for frontier coding, knowledge work, and reasoning tasks.

AI 与机器学习AI 智能体
3,348
xuchonglang
精选
xuchonglang GitHub avatar

investing-for-beginners

A structured investing guide for Chinese beginners covering US stocks, options, and cryptocurrency, with focus on foundational concepts and risk awareness.

区块链与 Web3
2,739
Krishnagangwal
精选
Krishnagangwal GitHub avatar

CS-Fundamentals

A curated collection of Computer Science fundamentals (PDFs, notes, cheatsheets, interview question banks) for placement preparation, covering seven core subjects plus general resources.

数据与数据库数据库与存储
2,326