Java Development Man

核心能力

本手册基于阿里巴巴Java开发手册（嵩山版），将规约分为7个维度。规约按约束力强弱分为：

【强制】

执行【强制】操作,处理用户输入并返回结果。

输入: 用户提供【强制】所需的参数和指令。

输出: 返回【强制】的处理结果。

• 执行【强制】操作，处理输入数据并返回结果
• 验证执行结果，确认输出符合预期格式
• 参考【强制】相关配置参数进行设置

【推荐】

执行【推荐】操作,处理用户输入并返回结果。

输入: 用户提供【推荐】所需的参数和指令。

输出: 返回【推荐】的处理结果。

• 执行【推荐】操作，处理输入数据并返回结果
• 验证执行结果，确认输出符合预期格式
• 参考【推荐】相关配置参数进行设置

【参考】

执行【参考】操作,处理用户输入并返回结果。

输入: 用户提供【参考】所需的参数和指令。

输出: 返回【参考】的处理结果。

• 执行【参考】操作，处理输入数据并返回结果
• 验证执行结果，确认输出符合预期格式
• 参考【参考】相关配置参数进行设置

能力覆盖范围

本skill还覆盖以下能力场景: 开发手册规约集合、大维度、编程规约、异常日志、单元测试、安全规约、MySQL、数据库、工程结构、设计规约、Use、需要代码生成、编程辅助、调试测试、开发部署时使用、不适用于无明确技、术栈的模糊需求、适用于独立开发者、企业团队和自动化、工作流场景。这些能力在上述核心功能中均有对应处理逻辑。

适用场景

1. 命名检查 → 查看 coding-convention.md 的"命名风格"章节
2. 并发问题 → 查看 coding-convention.md 的"并发处理"章节
3. 异常处理 → 查看 exception-log.md
4. 安全问题 → 查看 security.md

使用流程

Step 1: 内容解析

按审查标准执行检查 解析待审查内容, 提取以下要素:

• 关键要素: 关键要素
• 关键要素: 关键要素

Step 2: 逐项检查

按审查标准执行检查 按照 references/checklist.md 中的检查清单逐项审查:

Step 3: 评级判定

按审查标准执行检查 根据检查结果评定等级:

• A级(优秀): 符合标准
• B级(良好): 符合标准
• C级(及格): 符合标准
• D级(不及格): 符合标准

Step 4: 生成报告

按审查标准执行检查 输出审查报告, 包含: 总评/各项详情/改进建议/优先级排序。

输入格式

输出格式

{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}

异常处理

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux

依赖说明

API Key 配置

-

可用性分类

• 分类: MD+EXEC()
• 说明: 基于Markdown的AI Skill,

API Key配置方式:

export API_KEY="your_api_key_here"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统。

案例展示

示例1：基础用法

### 代码审查场景

1. **命名检查** → 查看 [coding-convention.md](/api/v1/skills/java-development-manual/file?path=references%2Fcoding-convention.md&ownerHandle=shinelon) 的"命名风格"章节
2. **并发问题** → 查看 [coding-convention.md](/api/v1/skills/java-development-manual/file?path=references%2Fcoding-convention.md&ownerHandle=shinelon) 的"并发处理"章节
3. **异常处理** → 查看 [exception-log.md](/api/v1/skills/java-development-manual/file?path=references%2Fexception-log.md&ownerHandle=shinelon)
4. **安全问题** → 查看 [security.md](/api/v1/sk

常见问题

Q1: 如何开始使用Java Development Man？

A:

Q2: 遇到错误怎么办？

A:

Q3: Java Development Man有什么限制？

A:

错误处理

已知限制

-

-

-