前言¶
接手需求时，小改动牵出无关 diff、口头需求做着就偏、加字段忘了数据兼容、隔一个月想不起当时设计、会话中断后不知道从哪续——这些在 Spring Boot 日常迭代里很常见。单靠「让模型多写点注释」解决不了流程问题：缺的是环境上下文、模式选择和可恢复的交付节奏。
下面介绍 SkillHub 上的 JavaStoryDevelop（坐标 @user_c131cbf8/java-story-develop，当前版本 2.1.7，社区来源，发布者 user_c131cbf8）。它把环境探测、三种工作模式、编码对照和文档归档捆成一套 SKILL.md 能力包，目标是让 AI 按规范走完「你说要改什么 → 可交付代码与文档」的全过程。
这是什么¶
JavaStoryDevelop 是面向 Java / 全栈需求落地的 Agent Skill：自动感知 JDK、Spring Boot、ORM、数据库及前端框架，写入记忆后下次沿用；检测到前端时可选择是否进入全栈协作。SkillHub 分类为 dev-programming，标签 requires_api_key=false，无需额外 API Key。
官方入口：
- API 坐标页：https://api.skillhub.cn/user_c131cbf8/java-story-develop
- SkillHub 展示页：https://www.skillhub.cn/skills/user_c131cbf8/java-story-develop
核心功能¶
项目环境感知与主动记忆¶
进入项目后 Skill 会探测 JDK、Spring Boot、ORM、数据库、前端框架等，并记入记忆；后续会话不再重复问环境。若存在前端工程，会询问是否启用全栈模式一并处理。
三种工作模式（各有状态机）¶
| 模式 | 适用场景 | 流程要点 |
|---|---|---|
| SIMPLE | 小 Bug、改字段 | 一张文档串联：需求 → 改动 → 验证，轻量 |
| QUICK | 常规功能迭代 | 分析现状 → 设计方案 → 编码实现 |
| FULL | 跨模块重构、加表、对接外部系统 | 从需求澄清到闭环反馈，七步完整交付 |
每种模式都有明确状态机，当前步骤可追踪。
规范、角色与质量兜底¶
- 11 条编码规范：分层架构、空值防护、并发、日志、事务、测试验证等，写代码时对照。
- 角色互搏：设计阶段分别以开发与产品视角推敲需求，降低模糊带来的返工。
- 异常恢复：中断后读取
context.json回到断点，无需从头开始。 - 文档沉淀：按需求编号归档，改动与时间线可查。
- 复盘检查：四轮迭代收尾时做边界加固、风险扫描、冲突检查。
安装与启用¶
SkillHub 页面给出的安装方式是：让当前 AI 按官方安装文档安装该坐标。也可在已安装 skillhub CLI 时，把 Skill 装到当前 Agent 的 skills 目录（装错目录 Agent 不会加载）。
1、检查 CLI（可选）：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 文档执行完整安装或仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装 JavaStoryDevelop（将 <skills 目录> 换成你正在用的客户端路径）：
skillhub install @user_c131cbf8/java-story-develop --dir <skills 目录>
常见 skills 目录（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
若用自然语言交给 AI 安装，可使用 SkillHub 页面提示：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_c131cbf8/java-story-develop`。
安装后按你所用 Agent 的惯例刷新或重启，使新 Skill 被加载。
典型用法¶
在已启用 Skill 的 Java（或全栈）仓库里，用一句话说明目标和规模即可，由 Skill 选择模式并推进状态机。
SIMPLE 示例（改字段 / 小修）：
用 SIMPLE 模式：用户表增加 nickname 字段，接口返回要带上，给我改动说明和验证步骤。
QUICK 示例（功能迭代）：
用 QUICK 模式：订单列表支持按状态筛选，先分析现有 Controller/Service，再设计方案并实现。
FULL 示例（重构或跨模块）：
用 FULL 模式：把支付回调从单体模块拆到独立服务，需要需求澄清、库表与外部对接方案，最后闭环验证。
若会话中断，在同一项目继续时说明「从 context.json 恢复上次需求」；Skill 会按资料描述从断点续做。全栈场景下，在 Skill 询问时确认是否前后端一起改。
适用场景与注意¶
适合谁： 以 Java / Spring Boot 为主、偶尔带前端的团队；希望需求有文档、步骤可恢复、编码有固定对照表，而不是每次从零 prompt。
注意：
- 能力来自 Skill 内置流程与规范，不替代你们自己的代码评审与上线门禁。
context.json与按编号归档的文档依赖项目内实际落盘方式，团队应约定是否纳入版本库。- SkillHub 统计（截至页面与抓取资料）：评分 100000，下载 1689；与第三方转载的数字可能不一致，以 SkillHub 为准。
- 未在官方说明中单独列出 Cursor / Codex / Claude Code 的差异时，差异主要体现在 skills 安装路径，行为以 SKILL 正文为准。
结尾¶
JavaStoryDevelop 把环境记忆、SIMPLE / QUICK / FULL 三档模式、11 条编码对照和 context.json 断点恢复串成一条可回溯的需求链路，适合想把「改一个小字段」和「跨模块重构」都管在同一套章法里的 Java 开发者。
安装与说明：https://www.skillhub.cn/skills/user_c131cbf8/java-story-develop
