SourceAtlas 未來功能的完整設計文檔。
-
- 實作為:
/atlas.flow(v2.7.0) - 完成日期: 2025-12-01
- 成果: 11 種分析模式、語言專屬入口點偵測、漸進式展開
- 文檔保留供參考
- 實作為:
-
- 實作為:
--save參數 +/atlas.reset(v2.9.1) - 完成日期: 2025-12-12
- 成果: 所有分析命令支援
--save，新增/atlas.reset清空命令 - 文檔保留供參考
- 實作為:
-
- 實作為:
/atlas.list增強 (v2.9.2) - 完成日期: 2025-12-13
- 成果: 過期標記（
⚠️ ）、統計、可複製的--force命令
- 實作為:
-
- 完成日期: 2025-12-16
- 成果: CLAUDE.md 從 1,108 行精簡到 499 行（-55%）
- 關鍵發現: @import 非 lazy loading，改採 Delete + Rules 方案
- 新增:
.claude/rules/dev-notes-rules.md
-
- 實作為: Default auto-save (v2.12.0)
- 完成日期: 2026-01-03
- 成果: 移除
--save參數，改為默認存儲 - 來源: MCP vs Skills 社群討論洞見
- 變更: 6 個命令自動存儲到
.sourceatlas/
-
- 實作為: OpenSkills 相容格式 (v2.12.0)
- 完成日期: 2026-01-10
- 成果: 8 個 commands 轉換為
{name}/SKILL.md目錄格式 - 支援: Claude Code + Cursor + Gemini CLI + Windsurf + Aider
- 安裝:
openskills install lis186/SourceAtlas
（目前無）
（目前無）
-
漸進式輸出 (Progressive Disclosure)
- 目標: 根據專案規模智慧調整輸出詳細程度
- 狀態: 部分完成後擱置（2025-12-18）
- 已完成:
/atlas.patternSmart 模式 +--brief/--full(v2.9.3) - 擱置原因:
/atlas.overview等命令通常只執行一次，已有快取機制- 增加維護複雜度，效益有限
- 假設未經驗證，無使用者反饋需求
- 重新評估: 若有使用者抱怨「輸出太多」或 token 成本問題
-
- 目標: 將 patterns 從 shell script 硬編碼改為 YAML 配置檔
- 狀態: 擱置（2025-11-30）
- 原因: 經多角色審查後決定暫不實作
- PM 評估：無使用者需求，ROI 為負
- 現有發現機制（
find-patterns.sh無參數）已足夠 - 優先完善現有 commands 和多語言支援
- 未來: 待使用者明確需求時再評估
-
- 目標: 一鍵刷新所有過期的分析快取
- 狀態: 擱置（2025-12-13）
- 原因: 架構師審查認為過度工程化
- 99% 使用者只有 3-5 個快取，手動
--force就夠 - 檔名→命令映射太脆弱（截斷檔名無法還原）
- 問題未經驗證，持久化功能才剛推出
- 99% 使用者只有 3-5 個快取，手動
- 替代方案:
/atlas.list提供可複製的--force命令 - 重新評估: 如果使用者抱怨「我有 20+ 個快取要刷新」
-
- 目標: 根據分析類型使用不同的過期閾值（7/14/30/60 天）
- 狀態: 擱置（2025-12-13）
- 原因: 架構師審查認為增加不必要的複雜度
- 假設未經驗證（history 真的需要 7 天更新嗎？）
- 增加認知負擔（使用者會困惑不同閾值）
- 違反 SourceAtlas「簡單、統一介面」哲學
- 替代方案: 保持 30 天統一閾值，使用者自行判斷
--force - 重新評估: 除非有明確證據證明差異化閾值解決真實問題
ideas/*.md
↓ (1-4 週研究驗證)
↓ 確認價值和可行性
proposals/feature-name/
↓ (排入 roadmap)
↓ 開始實作
dev-notes/YYYY-MM/implementation.md
每個提案必須包含：
-
清晰的使用場景
- 解決什麼問題？
- 誰會使用？
- 為什麼需要？
-
完整的技術設計
- 架構方案
- 技術選型和理由
- 實作範例
-
可行性驗證
- 在真實場景測試
- 技術風險評估
- 替代方案比較
-
實作計畫
- 具體步驟（不含時間估算）
- 測試策略
- 文檔要求
如果你在 ideas/ 有想法已經成熟：
- 確認符合提案要求
- 創建
proposals/feature-name/目錄 - 撰寫完整文檔
- 更新本 README（在「🔵 待評估」區段新增）
- 開 Issue 討論
- 先在
ideas/做初步研究（1-4 週） - 驗證可行性
- 按上述步驟升級到 proposals/
| 狀態 | 說明 | 下一步 |
|---|---|---|
| 🔵 待評估 | 設計完成，等待 review | 團隊討論、決策 |
| 🟢 已批准 | 已同意實作，待排程 | 排入 roadmap |
| 🟡 研究中 | 從 ideas/ 升級，持續完善 | 補充設計細節 |
| ⚪ 擱置 | 決定暫不實作，保留設計 | 待使用者需求再評估 |
| ⚫ 已歸檔 | 已實作或已放棄 | 移到 dev-notes/ 或刪除 |
- 討論提案: 在對應 Issue 留言
- 提供反饋: PR 補充或修正
- 提出新想法: 先到
ideas/探索
- ideas/ - 實驗性想法孵化區
- dev-notes/ - 已完成功能的實作記錄
- ROADMAP - 開發路線圖