Skip to content

feat(skills): add fuck-u-code-analysis skill for AI agent code qualit…#158

Open
Zerone-Agent wants to merge 1 commit into
Done-0:mainfrom
Zerone-Agent:main
Open

feat(skills): add fuck-u-code-analysis skill for AI agent code qualit…#158
Zerone-Agent wants to merge 1 commit into
Done-0:mainfrom
Zerone-Agent:main

Conversation

@Zerone-Agent
Copy link
Copy Markdown

feat(skills): 新增 fuck-u-code-analysis 技能,支持 AI Agent 自动化代码质量审查

概述

新增一个专为 AI 编程 Agent(opencode、Claude Code、Cursor 等)设计的技能文件。Agent 在完成编码后,可自动调用 fuck-u-code analyze 获取量化指标,并根据技能中定义的审查标准给出具体可执行的整改建议——无需依赖 CLI 的 AI 审查功能。

新增文件

skills/fuck-u-code-analysis/SKILL.md(主文档)

  • 4 步工作流:运行分析 → 读取 JSON → 定位问题 → 输出整改报告
  • 评分权重体系:复杂度 32%、重复度 20%、代码量 18%、结构 12%、错误处理 8%、文档 5%、命名 5%
  • 11 项指标详解:每项指标包含定义、四级阈值(excellent/good/acceptable/poor)、常见问题模式、整改方案模板
  • 审查标准:按优先级分诊(性能 > 安全 > 可维护性 > 风格),所有建议必须锚定指标数据,标注具体文件:函数:行号
  • 输出格式:与项目 AI review 一致的 Markdown 结构(概述 → 关键问题 → 重构计划 → 安全隐患)

skills/fuck-u-code-analysis/references/thresholds.md(阈值参考表)

  • 覆盖全部 14 种支持语言(Go、JS、TS、Python、Java、C、C++、Rust、C#、Lua、PHP、Ruby、Swift、Shell)
  • 每种语言 6 项指标 × 4 级阈值,均标注行业来源(ESLint、SonarQube、Pylint、RuboCop、SwiftLint、Clippy 等)

skills/README.md(安装指南)

  • 安装方式、快速上手、前置依赖说明

工作原理

Agent 完成编码
  → 读取本技能
  → 执行: fuck-u-code analyze . -f json -o /tmp/fuc-report.json
  → 按语言特定阈值解读指标数据
  → 输出包含精确文件:函数:行号引用的整改方案

设计要点

  • 不依赖 CLI AI 审查:技能本身就是审查规范,LLM 读取分析数据后自行产出建议,无需调用 fuck-u-code ai-review
  • 阈值与源码一致:所有 14×6 阈值数据直接提取自 src/metrics/thresholds/language-thresholds.ts,确保技能与工具实际评分逻辑完全同步
  • 审查框架源自项目 AI prompt:优先级排序、质量规则、输出格式均适配自 src/ai/prompts/code-review.tssrc/ai/index.ts

文件变更

文件 行数 说明
skills/README.md +54 安装与快速上手
skills/fuck-u-code-analysis/SKILL.md +418 技能主文档
skills/fuck-u-code-analysis/references/thresholds.md +180 各语言阈值表

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant