📝 docs(codex_skills): normalize markdown formatting

This commit is contained in:
csh
2025-12-22 15:36:58 +08:00
parent cc8ad4c59c
commit a52bb246ab
13 changed files with 109 additions and 2 deletions
@@ -6,31 +6,38 @@ description: "Safe bulk refactors and mass edits across a repo (rename APIs, glo
# Bulk Refactor Workflow(批量重构 / 大范围修改)
## When to Use
- Rename API / symbol / file convention across many files
- Mechanical refactors (imports, formatting, lint fixes, signature migrations)
- Cross-cutting changes touching 10+ files
## Inputsrequired
- Scope:目录/文件类型/排除项(include/exclude
- Transformation:要做的规则(rename A→B、替换模式、接口迁移策略)
- Constraints:是否允许行为变化?是否需要兼容期?是否允许自动格式化?
- Verification:必须通过哪些命令/检查(最少一个)
## Proceduredefault
1. **Baseline**
- 确保工作区干净:`git status --porcelain`
- 跑一个基线验证(至少 build 或核心测试子集),避免“本来就坏”
2. **Enumerate**
- 先搜索再改:用 `rg`/`git grep` 列出全部命中
- 分类命中:真实调用 vs 注释/文档/样例;避免误改
3. **Apply Mechanical Change**
- 优先使用确定性的机械变换(脚本/结构化编辑)而非手工逐个改
- 每轮改动后立即做小验证(编译/单测子集)
- 复杂迁移优先“两阶段”:先兼容旧接口(deprecated),再清理旧接口
4. **Format & Lint(按项目约定)**
- 仅在确认“会破坏 diff 可读性”前提下分批格式化(避免把重构和格式揉在一起)
5. **Verify & Report**
@@ -38,9 +45,11 @@ description: "Safe bulk refactors and mass edits across a repo (rename APIs, glo
- 汇总影响范围:改动文件数、主要改动点、潜在风险
## Execution Hintoptional
如果环境支持“执行型批量处理”(例如脚本执行),优先用脚本完成批量修改,然后只把**最小 diff + 摘要**交付,避免上下文膨胀与漏改。
## Output Contractstable
- Scope:改动覆盖范围(文件/目录/语言)
- Transformation:执行的规则(可复用)
- Changes:关键改动摘要(按类别)
@@ -48,5 +57,6 @@ description: "Safe bulk refactors and mass edits across a repo (rename APIs, glo
- Risks:高风险点与回滚建议
## Guardrails
- 任何“全局替换”都必须先给出命中清单与排除策略
- 避免把行为重构与格式化/无关清理混在同一轮