前言¶
接手需求時，小改動牽出無關 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
