Home / devcodex-labs / devcodex · GitHub

dev-refactor SKILL.md skillA

dev-refactor from devcodex-labs/devcodex is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned

mdr add devcodex-labs/devcodex/dev-refactor@git:20260730.6ee304a

Pins git:20260730.6ee304a in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 17 of 17 checks passed
Kind: SKILL.md skill
Repository: devcodex-labs/devcodex
Path: content/skills/dev-refactor/SKILL.md
Versions recorded: 1
Latest version: git:20260730.6ee304a, committed Jul 30, 2026
Size: 1,736 bytes
Repository stars: 432
License: AGPL-3.0

重构子类型规范 — 测试覆盖前置确认 + 三段式重构流程.

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

# Dev Refactor Skill

## 触发条件

用户意图为重构现有代码（不改变外部行为），典型场景：提取公共模块、消除重复代码、改善架构分层、升级编码风格。

## 前置检查（必须在 CP1 前完成）

| 项 | 内容 |
|----|------|
| 测试覆盖确认 | 确认被重构模块已有测试覆盖（单测/集成测试），无测试时**禁止继续**，优先补测试 |
| 基线快照 | 记录当前接口签名、导出列表、公开 API |
| 类型契约基线 | TypeScript 项目须区分必须保持兼容的公开类型契约与允许修正的旧类型缺陷 |

## 执行流程

```text
CP1（范围确认）→ CP2（方案确认）→ [plan-review] → [impact-review] → CP3（计划确认）→ 执行
```

**plan-review**：PR-1 在 CP2 前自检，PR-2~PR-7 在 CP2→CP3 之间执行；PR-5② 跨模块依赖变更时继续 `impact-review`，🔴 阻断时回 CP2。

**执行阶段**：
1. 最小增量重构，每步可独立回滚
2. 重构后运行测试套件（零新增失败）
3. 更新 API 文档（若接口签名变更）
4. document-sync（更新架构文档）

## 关键规则

- 🔴 重构前测试覆盖率不足时，**必须先补测试再重构**（C-REF-01）
- 禁止在重构 PR 中混入功能变更（行为不变原则）
- Breaking Changes 必须在 CP2 中列出并评估
- TypeScript 类型迁移或重构不得机械复制旧版本类型缺陷；应按公开契约与消费面逐步完善，跨模块业务契约、公开类型与配置类型优先集中到 types 契约层，本地私有 interface 可保留但须说明理由

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add devcodex-labs/devcodex/dev-refactor@sha256:292dc109806225cf

The line at the top of this page pins the label git:20260730.6ee304a, 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](https://markdownregistry.com/badge/art_2diqfo33a6n3tg5z.svg)](https://markdownregistry.com/a/art_2diqfo33a6n3tg5z)

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

Versions

The registry has recorded 1 version of this file, committed on Jul 30, 2026.

version	committed	commit	size	audit
git:20260730.6ee304a latest	2026-07-30	6ee304a	1,736 B	A	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 (1736 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

devcodex-labs/devcodex · 432 stars · license AGPL-3.0 · pushed 2026-10-27 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_2diqfo33a6n3tg5z
GET https://markdownregistry.com/api/v1/resolve?ref=devcodex-labs/devcodex/dev-refactor
GET https://markdownregistry.com/api/v1/blob/292dc109806225cf977c2691c405357490eeafe157a5a050a94c691183239bc9

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 devcodex-labs/devcodex

accessibility-i18n SKILL.md skill

devcodex-labs/devcodex · content/skills/accessibility-i18n/SKILL.md · 无障碍与国际化专家 Owner — 当任务涉及可访问性、键盘操作、焦点、屏幕阅读器、ARIA、语言地区、本地化、RTL、翻译资源、用户可见文案或多语言文档时使用；要求把包容性体验和本地化验证绑定到真实用户路径。