source-coding-discipline SKILL.md skillA

source-coding-discipline from martin1847/evolab is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add martin1847/evolab/source-coding-discipline@v0.1.2

Pins v0.1.2 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
martin1847/evolab
Path
skills/source-coding-discipline/SKILL.md
Versions recorded
4
Latest version
v0.1.2, committed Jul 30, 2026
First version recorded
Jul 4, 2026
Size
2,387 bytes
Repository stars
7
License
MIT

Use when a task involves reading, editing, reviewing, testing, debugging, refactoring, or otherwise working with source code files. Source paths include **/*.{py,ts,tsx,js,jsx,mjs,go,rs,java,kt,swift,rb,c,cc,cpp,h,hpp,sh,bash,zsh,sql,vue,svelte}. Do not use for docs-only, planning-only, or non-code file tasks unless the task also touches source code.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 写码纪律(碰源码文件时加载)

> 镜像注:四段纪律正文与本仓库 `templates/rules/coding.md` 同源(路径相对 evolab 仓库根;本 skill
> 单独 cp 安装后该文件不随行,同步义务只落在仓库维护侧)——
> rules 形态给支持 `paths:` 条件加载的 agent(Claude Code / omp),skill 形态给不支持的(codex 等)。
> **改任一边必须同步另一边**(硬门:`test/mirror-sync.test.sh` 四段逐字 diff,漂移即红);
> 同一 agent 勿两种形态同装(双重注入)。

**先思考再编码**:显式说出假设,不确定就问;多种解读全部列出、不静默选边;有更简单的路径就说出来;困惑就停下来问。

**简单优先——交付物代码零投机(仅限交付物;风险枚举 / 预判 / 评审轴不受此限、该大胆发散)**:不做超出要求的功能;单次使用的代码不抽象;没要求的"灵活性/可配置性"不引入;不可能发生的场景不写错误处理。写了 200 行能压到 50 行的,重写。自问:"资深工程师会觉得这过度复杂吗?"

**外科手术式改动**:每一行改动都能直接追溯到用户请求。不"改进"邻近代码/注释/格式,顺应已有风格。自己的改动产生的孤儿(未用 import/变量/函数)要清;既有死代码指出来、不删。

**目标驱动执行**:把任务转成可验证目标——"加校验"→"为非法输入写测试并让它过";"修 bug"→"先写能复现的测试再修到过";"重构"→"改前改后测试都过"。多步任务先列简短计划:`步骤 → 验证`。强验证标准让你独立循环,弱标准("能跑")需要不停澄清。

**验证诚实性**:禁止声称测试通过、命令成功、文件存在,除非实际跑过 / 读过。未跑就说"未运行验证"。完成时简短说明:改了什么 / 跑了什么验证 / 什么没验证 / 剩余假设或风险。

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add martin1847/evolab/source-coding-discipline@sha256:f9cf23b71358589b

The line at the top of this page pins the label v0.1.2, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_axde2opp2iwxriah.svg)](https://markdownregistry.com/a/art_axde2opp2iwxriah)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Jul 4, 2026 and Jul 30, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
v0.1.2 latest2026-07-30 ecf44b5 2,387 BA view · diff
v0.1.12026-07-04 6994dad 2,405 BA view · diff
v0.1.02026-07-04 de5e50f 2,305 BA view · diff
git:20260704.c9296df2026-07-04 c9296df 2,290 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2387 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

martin1847/evolab · 7 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_axde2opp2iwxriah
GET https://markdownregistry.com/api/v1/resolve?ref=martin1847/evolab/source-coding-discipline
GET https://markdownregistry.com/api/v1/blob/f9cf23b71358589bb555d5af685dab7d48096527e83b131ce2dd304c3af1806e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from martin1847/evolab

agent-backend-standard SKILL.md skill
martin1847/evolab · skills/agent-backend-standard/SKILL.md · 后端架构与工程规范。适用于构建或评审 agent/LLM 后端、任何涉及数据库(DB)的后端,以及建立或评审后端仓库工程门禁。
v1.4.3 · audit A · 7 stars
agent-frontend-standard SKILL.md skill
martin1847/evolab · skills/agent-frontend-standard/SKILL.md · 前端工程规范。适用于编写或评审前端/UI 代码(React、React Native/RN、Next.js、组件、样式、状态、测试)、建立前端工程门禁或将设计系统对接 AI。不用于仅从新用户视角探索产品卡点;该场景使用…
v1.0.1 · audit A · 7 stars
agent-mail SKILL.md skill
martin1847/evolab · skills/agent-mail/SKILL.md · 多编排者/长期 agent 身份之间的异步信箱总线——发信、收信、回信、归档、名册注册。每个身份一个 inbox,一封信只有一个去处(收件人 inbox),收信只查自己信箱。触发:给另一个编排者/CTO/agent…
v0.1.14 · audit A · 7 stars
cto-orchestration SKILL.md skill
martin1847/evolab · skills/cto-orchestration/SKILL.md · 以 CTO/orchestrator 模式管理多 agent 软件交付。用户要求“你做 CTO/编排者”“派 omp/codex 去做”“goal…
v1.8.0 · audit A · 7 stars
frontend-explorer SKILL.md skill
martin1847/evolab · skills/frontend-explorer/SKILL.md · 探索型前端测试——派一个「第一次见这个产品」的探索者,用 playwright-cli 驱真浏览器走完一段旅程,回一份按挡路程度排序的「在哪卡住 / 哪里看不懂」清单,每条带屏幕原文与截图证据。触发:探索一遍 / 走一遍 / 踢踢轮胎 /…
v0.1.2 · audit A · 7 stars
git-workflow-standard SKILL.md skill
martin1847/evolab · skills/git-workflow-standard/SKILL.md · 生产级 Git 协作 SOP:受保护分支按仓库 tier 门禁、改动从 feature 分支起、集成默认 squash、rebase 判据、提交不加 AI 签名。任何 git commit / push / 开 PR / 建分支 /…
v1.2.0 · audit A · 7 stars
observability-standard SKILL.md skill
martin1847/evolab · skills/observability-standard/SKILL.md · 适用于编写或评审任何后端服务,包括普通服务与 agent/RAG 系统。覆盖日志、tracing、OpenTelemetry、上下文传播、日志级别、trace/log/DB 关联、边界类型及…
v1.3.3 · audit A · 7 stars
orchestrator-core SKILL.md skill
martin1847/evolab · skills/orchestrator-core/SKILL.md · 多智能体编排的领域无关内核。适用于抽象编排模式、创建新领域编排者,或设计多智能体架构。实际软件交付编排使用 cto-orchestration。不用于单 agent 一次性小任务或纯文档初始化。
v0.2.4 · audit A · 7 stars
repo-governance-bootstrap SKILL.md skill
martin1847/evolab · skills/repo-governance-bootstrap/SKILL.md · 一次性初始化 AI 协作项目的轻量工程治理骨架。新仓库 / 文档治理初始化时调用(也是 cto-orchestration 接入新项目的第一步)。One-shot governance bootstrap for a new repo.
v1.5.5 · audit A · 7 stars

Every file in martin1847/evolab

Browse by kind, by grade A, or by owner.