@bovinphang/frontend-craft 2.8.0 → 2.9.0

package/localized/zh-CN/skills/fec-code-review/references/report-template.md

@@ -6,6 +6,14 @@
 > 生成时间: YYYY-MM-DD HH:mm
 > 评审工具: frontend-craft
 
+> 审核模式：改动审核 / 指定范围审核 / 全项目审核
+> 目标范围：路径或 PR/提交
+> 已审核：文件或模块清单
+> 排除项：路径及原因
+> 未覆盖：剩余文件或模块清单（无则注明）
+> 完成状态：完成 / 部分完成
+> 验证结果：命令、结果及未执行原因
+
 ## CRITICAL / 必须修改 (N项)
 - **[文件:行号]** 问题描述 -> 建议修改
 
@@ -23,7 +31,9 @@
 
 ## 风险等级：低 / 中 / 高
 
-**总体评价**: 可合并 / 待修改后合并 / 需要重构
+**总体评价**: 改动审核填写合并建议；指定范围或全项目审核填写低 / 中 / 高风险及阻塞问题
 ```
 
 评审完成后，将报告保存到 `reports/code-review-YYYY-MM-DD-HHmmss.md`，并告知用户报告路径。
+
+改动审核保留合并建议；指定范围和全项目审核输出风险评估。部分完成时，结论仅适用于已审核范围，不构成全项目通过结论。

package/localized/zh-CN/skills/fec-code-smells/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: fec-code-smells
+description: 需要在不修改业务代码的前提下诊断既有前端代码的结构性可维护性问题，并要求提供证据、误判检查与候选重构方向时。
+---
+
+# 代码坏味道诊断
+
+## 概览
+基于具体证据诊断结构问题。坏味道是进一步调查的信号，不等于必须修改代码的结论。
+
+## 执行流程
+1. 明确分析范围和项目事实。
+2. 收集结构、依赖方向、职责和变化耦合证据。
+3. 对照[坏味道目录](references/smell-catalog.md)。
+4. 执行[误判检查](references/detection-guide.md)。
+5. 根据[坏味道到重构手法映射](references/smell-to-refactoring-map.md)报告置信度、影响和候选方案。
+6. 如果用户只要求诊断，不修改业务代码。
+
+## Finding 输出契约
+每项必须包含位置、证据、坏味道 ID/名称、影响、置信度（`HIGH`、`MEDIUM`、`LOW`）、候选重构、优先级和重要误判因素。`LOW` 置信度不能作为自动修改依据。
+
+## 快速索引
+| 需要 | 资料 |
+| --- | --- |
+| 24 种标准坏味道 | [坏味道目录](references/smell-catalog.md) |
+| 证据与误判保护 | [检测指南](references/detection-guide.md) |
+| 候选重构手法 | [映射指南](references/smell-to-refactoring-map.md) |
+
+## 常见错误
+- 把指标阈值当成坏味道证据。
+- 不指出文件/符号就下结论。
+- 把所有循环、switch、注释、包装层或管道都视为缺陷。
+- 用户要求只诊断时仍直接改代码。

package/localized/zh-CN/skills/fec-code-smells/references/detection-guide.md

@@ -0,0 +1,25 @@
+# 代码坏味道检测指南
+
+## 证据优先
+优先观察代码结构、依赖方向、数据所有权、重复变化模式和实际维护负担。指标只能帮助定位，不能单独证明坏味道。
+
+## 必须执行的误判保护
+- 不能仅凭代码行数认定“过长函数”或“过大的类”。
+- 单个 `switch` 不能证明“重复的 switch”。
+- 函数链或数组管道不自动等于“过长的消息链”。
+- 注释本身不是缺陷。
+- 不可变的传输数据可以合理地保持纯数据形态。
+- React/Vue 声明式组合不自动等于“中间人”。
+- `filter().map().reduce()` 管道不是消息链。
+
+## 前端证据检查
+- 核对 props、store、API DTO、Hook/Composable 与模块的数据所有权。
+- 判断 effect/watch 等生命周期语义后，再评价重复或链式耦合。
+- 推荐搬移前核对组件、路由、事件和包导出的公共契约。
+- 检查动态引用：懒加载、路由注册、Storybook、i18n key、运行时模板和动态 CSS class。
+- 区分真正的领域规则重复与仅仅外观相似的渲染代码。
+
+## 置信度
+- **HIGH：** 有直接、重复证据，且重要误判因素已排除。
+- **MEDIUM：** 证据成立，但历史、动态引用或所有权仍不完整。
+- **LOW：** 主要依据表面指标或存在重大不确定性；只报告，不自动修改。