Community研究與資料分析github.com

Jeremy-01/intake-first-planner

Codex 技能:先進行資料架構擷取,再進行規劃與求解器實作

intake-first-planner 是什麼?

此技能專注於「先擷取輸入架構,再進行實作」的開發流程,特別適合物理佈局規劃、工作空間與家具配置、設備擺放、纜線佈線、排程與資源最佳化、模擬設定等需依賴明確參數的領域。它引導開發者或 AI 夥伴在開始任何解得、最佳化或領域邏輯程式碼之前,先產出結構化的事實來源(如 YAML 或 JSON),避免因猜測參數而導致的錯誤。技能支援多種平台(如 Codex、Claude Code 等),並提供從基本工作流程、空間領域參考、Three.js 視覺化到技能封裝的完整參考文件。若關鍵資料遺漏,它會輸出「遺失參數」的阻斷回應,而非直接實作,確保專案從正確的事實基礎出發。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add Jeremy-01/intake-first-planner

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

先擷取架構的規劃器

使用此技能的專案必須避免從猜測的參數開始:物理佈局規劃、工作空間或家具配置工具、設備擺放、纜線佈線、排程/資源最佳化、模擬設定,以及類似的限制解決系統。假設使用者可能是完全初學者:以白話說明需要哪些資訊,提供可填寫的 YAML,並避免要求他們理解實作細節。

核心規則

在所需的事實和情境足夠明確、使得假設不再必要之前,請勿進行求解、最佳化、建議或搭建領域專用邏輯。如果關鍵資料遺漏,請輸出「遺失參數」的擷取回應,然後在實作之前停止。

工作流程

  1. 分類請求:
    • 僅擷取:使用者想要需求、架構或提示清理。
    • 擷取後建置:使用者想要程式碼、測試、報告或可重複使用的專案。
    • 技能創作:使用者想要可重複使用/開源的技能或提示套件。
  2. 選取相關參考:
    • 一般可重複使用工作流程:閱讀 references/intake-workflow.md。
    • 空間/佈局規劃器:閱讀 references/spatial-layout-domain.md。
    • Three.js 報告或 3D/視覺輸出:閱讀 references/threejs-visualization.md。
    • 將一次性提示轉換為可重複使用技能:閱讀 references/prompt-to-skill.md。
    • 技能封裝/開源轉換:閱讀 references/skill-packaging.md。
  3. 產生或更新結構化的事實來源,通常為 YAML 或 JSON。
  4. 執行閘控:
    • 若必需事實遺漏,僅返回遺失參數核對清單、建議的架構片段、所需情境以及明確的非假設事項。
    • 若事實完整,則使用事實來源作為權威輸入來實作專案。
  5. 對於 Python 專案,優先使用 uv 指令。務必在交接/復原文件中加入 venv + pip 復原指令。
  6. 除非使用者明確要求歷史復原,否則請勿讀取舊工作階段的 JSONL、聊天記錄或先前的對話。

輸出模式

對於輸入遺失的情況,使用此格式:

在我能安全解決此問題之前,我需要幾個具體的測量值。您可以透過填寫下方的 YAML 來回答;未知的值可以保留為 `null`。

**遺失參數**
- ...

**建議的 YAML**
```yaml
...
```

**待確認情境**
- ...

**未假設事項**
- ...

對於實作,請建立一個包含以下項目的專案:

  • pyproject.toml、src/、tests/、examples/、reports/、outputs/
  • 一個作為唯一事實來源的結構化設定範例
  • 當涉及幾何或佈局時,提供俯視圖 SVG/HTML 及 Three.js 3D HTML 檢視器的視覺化報告
  • 針對解析、轉換、限制、評分進行確定性測試,並至少包含一個情境回歸測試
  • HANDOFF.md、RECOVERY_README.md 和 PROJECT_CONTEXT.md,其中包含 uv 和 venv + pip 指令

可重複使用資產

  • schemas/intake_project.schema.yaml:通用架構範本。
  • schemas/spatial_layout.schema.yaml:空間/佈局架構範本。
  • references/threejs-visualization.md:預設 3D 視覺化指南。
  • examples/workstation_layout_request.yaml:領域請求範例。
  • examples/furniture_layout_request.yaml:房間/家具規劃範例。
  • examples/equipment_cable_routing_request.yaml:設備擺放與纜線佈線範例。
  • scripts/check_skill_package.py:輕量級套件完整性檢查器。

相關技能