mcpField
I
inspect-role-naming

inspect-role-naming

github.com/venhdev测试与质量159 次安装今天更新
代码仓库

关于 inspect-role-naming

inspect-role-naming 是依据仓库命名规范审查代码架构角色与命名的技能。它区分局部改名和结构重构，并生成包含审查结果的报告。

主要功能

  1. 01依据规范审查命名
  2. 02区分改名与重构问题
  3. 03忽略表面及低风险问题
  4. 04生成结构化审查报告

适用场景

  1. 01检查架构相关命名偏差
  2. 02识别职责描述不实的符号
  3. 03区分局部修复与结构调整

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/venhdev/skills --skill inspect-role-naming

安装后在 Claude Code 中输入/inspect-role-naming确认已加载。

附带文件references/role-naming-rubric.md

详细介绍

inspect-role-naming — 架构角色与命名审计器

领域准则

1. 范围与容忍度护栏（忽略什么）
  • 仅关注关键风险：只关注危险的架构性误述、运行时冲突或边界架构泄漏。
  • 容忍无害代码：宽容处理轻微的本地辅助函数（少于 3 个方法）、内部变量简短命名、访问器中的无害指标/日志记录以及外观样式差异。禁止强迫对可正常工作的内聚代码进行重构。
  • 权威依据：严格依据 references/role-naming-rubric.md（或宿主仓库的权威命名规范，后者始终优先）评估命名与角色是否一致。
2. 决策分流：[RENAME] 与 [REFACTOR]
  • [RENAME]（纯命名偏移）：底层职责单一且合理；只有标识符/后缀偏离了 references/role-naming-rubric.md。修复范围局部且风险低。
  • [REFACTOR]（角色名不副实 / 职责泄漏）：符号名称掩盖了多项不相关职责，或作出了虚假承诺（例如，仓库调用外部 API）。必须先进行结构提取，再重命名。

规范输出约定

# Role & Naming Audit Dossier: <Target Scope>

## 1. Executive Summary
- **Target Inspected**: `<directory_or_file_path>`
- **Health Rating**: <PRISTINE | LOCALIZED_DRIFT | SYSTEMIC_DEBT>
- **Primary Bottleneck**: <Single-sentence summary of greatest role or boundary hazard>

## 2. Load-Bearing Defect Catalog
### [<CRITICAL | MAJOR>] [<RENAME | REFACTOR>] <Dimension>: `<Target Symbol>`
- **Offending Code**: [<file>#L<N>](file:///path/to/file#L<N>)
- **Violated Rubric**: [<spec_or_rubric>](references/role-naming-rubric.md#anchor)
- **Smell**: <Observable contract mismatch or dangerous collision>
- **Action**: <[RENAME] New Identifier OR [REFACTOR] Minimal Separation Path>

*(Emit 'No load-bearing role or naming defects observed' if clean)*
路由
  • 单文件中的局部符号重命名或轻微布尔逻辑清理 →（通过 /simplify-audit）。
  • 多文件符号迁移或结构性角色提取 →（通过 /changeset）。

执行协议

  1. 接收与依据确认：

    • 接收目标路径（directory 或 files）。
    • 如果存在宿主仓库的命名标准，则以其为依据（项目权威规范优先）；否则读取并应用 references/role-naming-rubric.md。

  2. 当前轮次的务实审计：

    • 在当前轮次中，直接依据准则审计目标代码。
    • 执行第 1 节的容忍度护栏：严格忽略无害惯用写法、本地简短命名和可正常工作的辅助函数。
    • 对每项发现，明确归类修复方式为 [RENAME] 或 [REFACTOR]。

  3. 综合与轮次终止关卡：

    • 将发现汇总到规范输出约定中。
    • 确定健康评级（PRISTINE、LOCALIZED_DRIFT 或 SYSTEMIC_DEBT）。
    • 将已完成的审计报告呈现在对话流中，并立即终止当前轮次。

评论

支持 Markdown