Communitygithub.com

modbender/skill-library-mcp

查詢土地所有權、租約、地主資訊和土地付款。支援付款管理和租約續約的寫入操作。

skill-library-mcp 是什麼?

這項技能專為 FarmOS 系統設計,讓 AI 助手能夠完整管理農場的土地組合。它提供了全面的讀取與寫入端點,用於處理土地所有權、租約、地主關係、付款記錄以及年度土地成本。技能的核心原則是資料完整性,明確禁止使用會截斷結果的儀表板端點,並強制要求使用 `/all` 端點以確保資料完整。此技能支援所有主要 AI 代理平台如 Claude Code、Cursor 和 Codex,其運作方式是透過 RESTful API 與 FarmOS 實例進行互動。讀取操作(列出付款、租約、地主)使用無需驗證的整合端點,而寫入操作(將付款標記為已付、續約租約)則需要 JWT 令牌授權。它還包含了明確的資料完整性規則,例如絕不呈現部分資料、報告失敗情況,以及顯示完整記錄計數,使其特別適合用於關鍵的財務和營運決策。此技能透過各種基於日期和狀態的篩選器,以及在執行大量操作(如大量付款標記或租約續約)前必須先預覽的嚴格要求,大幅降低了錯誤風險。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/modbender/skill-library-mcp/tree/HEAD/data/farmos-land-portfolio

在你喜歡的 AI 中提問

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

說明文件

FarmOS 土地組合

追蹤自有與租賃土地、租約條款、地主關係、付款以及年度土地成本。

關鍵:資料完整性規則

絕對不可使用部分或不完整的資料。以下規則沒有協商空間:

  1. 絕對不可使用 /api/integration/dashboard — 它會將結果截斷為 5 筆資料。不完整的付款資料比沒有資料更糟,因為它會造成資料完整的假象。
  2. 一律使用下方列出的 /all 端點 以取得完整資料。
  3. 若端點回傳錯誤或空結果,請向使用者報告失敗。 不要默默退回其他端點或呈現部分資料。
  4. 一律說明回傳的記錄總數,讓使用者知道資料是完整的。範例:「找到 3 月份有 11 筆待付款,總計 $175,058。」
  5. 若無法取得完整資料,請明確告知。 「我無法取得完整的付款資料」遠比僅顯示 11 筆付款中的 5 筆要好。

觸發此技能的時機

  • 「我們的租約何時到期?」
  • 「Smith 地塊的租金是多少?」
  • 「今年的土地總成本是多少?」
  • 「顯示逾期付款」
  • 「地主的聯絡資訊」
  • 「每英畝成本按地塊劃分」
  • 「列出所有租賃地塊」
  • 「3 月份有哪些付款即將到期?」
  • 「下個月的現金需求」
  • 「將付款 [X] 標記為已付」
  • 「將所有 3 月付款標記為已付」
  • 「續約 Smith 的租約」
  • 「預覽租約續約」

存取控制

租約條款、租金金額和地主資訊為敏感的商業資料。僅限管理員或經理角色存取。

角色對應: 檢查 ~/.openclaw/farmos-users.json 中寄件者的角色。若使用者並非管理員或經理,請告知其無權存取土地組合資料。

API 基礎位址

http://100.102.77.110:8009

整合端點(無需驗證)— 僅限讀取操作

重要:寫入操作(標記已付、續約)請使用需要驗證的端點。讀取操作(列出付款、租約、地主)請使用整合 /all 端點。

付款(完整 — 使用此端點,非儀表板)

GET /api/integration/payments/all

  • 回傳所有付款的完整詳細資訊 — 地塊名稱、地主姓名、逾期狀態
  • 查詢參數:
    • status — pending(待處理), paid(已付), overdue(逾期), scheduled(排程中)
    • payment_type — rent(租金), mortgage(房貸), property_tax(地產稅), insurance(保險), improvement(改良), other(其他)
    • parcel_id — 按特定地塊篩選
    • due_date_from — YYYY-MM-DD 範圍起始
    • due_date_to — YYYY-MM-DD 範圍結束
    • crop_year — 按作物年度篩選
  • 範例:
    • 所有逾期:/api/integration/payments/all?status=overdue
    • 2026年3月付款:/api/integration/payments/all?due_date_from=2026-03-01&due_date_to=2026-03-31
    • 所有租金付款:/api/integration/payments/all?payment_type=rent

即將到來的付款(未來 N 天)

GET /api/integration/payments/upcoming?days=30

  • 回傳未來 N 天內所有即將到來的付款(無截斷)
  • 使用 days=60 或 days=90 進行更長期的預測

租約(完整)

GET /api/integration/leases/all

  • 回傳所有租約,包含地主聯絡資訊、租金條款、到期狀態
  • 查詢參數:
    • status — active(有效), expired(已過期)
    • landlord_id — 按地主篩選

即將到期的租約

GET /api/integration/leases/expiring?days=90

  • 回傳 N 天內所有即將到期的租約

地主(完整)

GET /api/integration/landlords/all

  • 回傳所有地主,包含聯絡資訊、有效租約數量、總英畝數、總租金

地塊

GET /api/integration/parcels

  • 回傳所有地塊,包含所有權類型、英畝數、縣
  • 查詢參數:ownership_type — owned(自有), leased(租賃)

摘要統計

GET /api/integration/summary

  • 總英畝數、自有/租賃細項、地塊/租約/地主數量、年度成本

年度土地成本(按月及實體劃分)

GET /api/integration/finance/costs?year=2026

  • 按類別(租金、房貸、稅金、保險)劃分的每月成本細項
  • 按實體劃分的細項
  • 查詢參數:year, entity_id

每塊田地的成本(用於損益表)

GET /api/integration/finance/cost-per-field?year=2026

  • 分配至生產田地的土地成本
  • 查詢參數:year, entity_id

逾期項目

GET /api/integration/tasks/overdue

  • 所有逾期付款和提醒 — 高優先級項目

可操作項目

GET /api/integration/tasks/actionable?days_ahead=30

  • 即將到來的付款、到期的租約、待處理的提醒

需驗證的端點 — 寫入操作

這些端點需要 JWT 驗證。請參閱下方驗證章節。

驗證

此技能存取受保護的 FarmOS 端點,需要 JWT 令牌。

取得令牌: 使用適當角色執行驗證輔助腳本:

TOKEN=$(~/clawd/scripts/farmos-auth.sh admin)

使用令牌: 將其作為 Bearer 令牌包含在請求中:

curl -H "Authorization: Bearer $TOKEN" http://100.102.77.110:8009/api/endpoint

令牌到期: 令牌有效期為 15 分鐘。若收到 401 回應,請重新請求一個新令牌。

將單筆付款標記為已付

POST /api/payments/{id}/mark-paid Authorization: Bearer {token} Content-Type: application/json

請求內文:

{
  "paid_date": "2026-02-15",
  "notes": "支票 #1234"
}

將多筆付款標記為已付(大量)

POST /api/payments/bulk/mark-paid Authorization: Bearer {token} Content-Type: application/json

請求內文:

{
  "payment_ids": [12, 34, 56],
  "paid_date": "2026-02-15",
  "notes": "批次支票作業"
}

按日期範圍將付款標記為已付

POST /api/payments/bulk/mark-paid-by-date Authorization: Bearer {token} Content-Type: application/json

請求內文:

{
  "due_date_from": "2026-03-01",
  "due_date_to": "2026-03-31",
  "paid_date": "2026-02-15",
  "payment_type": "rent",
  "notes": "3 月租金付款"
}

當使用者說「將所有 3 月付款標記為已付」或類似的大量基於日期的操作時,請使用此端點。

預覽租約續約

POST /api/leases/renewal-preview Authorization: Bearer {token} Content-Type: application/json

請求內文:

{
  "lease_ids": [5, 12],
  "new_start_date": "2027-03-01",
  "rent_increase_percent": 3.0
}

回傳:續約後租約的預覽,包含新的付款時程表。在執行大量續約前,務必先使用此端點以便使用者確認。

執行大量租約續約

POST /api/leases/bulk-renew Authorization: Bearer {token} Content-Type: application/json

請求內文:

{
  "lease_ids": [5, 12],
  "new_start_date": "2027-03-01",
  "new_end_date": "2028-02-28",
  "new_rent_amount": 52000.00,
  "rent_increase_percent": 3.0,
  "notes": "年度續約,調漲 3%"
}

重要: 務必先預覽,經使用者確認後再執行。

年終結轉預覽

POST /api/payments/year-end-rollover/preview Authorization: Bearer {token} Content-Type: application/json

請求內文:

{
  "from_year": 2026,
  "to_year": 2027
}

回傳:將為新作物年度建立的付款時程表預覽。

執行年終結轉

POST /api/payments/year-end-rollover/execute Authorization: Bearer {token} Content-Type: application/json

請求內文:

{
  "from_year": 2026,
  "to_year": 2027,
  "apply_rent_increase": true,
  "rent_increase_percent": 2.5
}

重要: 此操作會根據當前年度租約建立下一年度的付款時程表。務必先進行預覽。

禁止使用的端點 — 請勿使用

端點原因
GET /api/integration/dashboard會將結果截斷為 5 筆。絕對不可使用。

關鍵概念

  • 地塊 (Parcel): 土地單位 — 可能為自有或租賃。
  • 租約類型: 現金租金、作物分紅、彈性租金。
  • 租約到期: 追蹤此項至關重要 — 即將到期的租約需要積極處理。
  • 土地付款: 租金、房貸、地產稅、保險 — 每項都有到期日。

使用說明

  • 租約到期追蹤是價值最高的查詢 — 務必標記未來 6 個月內到期的租約。
  • 付款狀態(到期/逾期)至關重要 — 立即標記逾期付款。
  • 每英畝成本分析有助於比較自有與租賃的經濟效益。
  • 地主聯絡資訊屬於隱私 — 絕不可在管理員/經理管道外分享。
  • 被問到「現金需求」或「我們還欠多少」時,一律使用 /api/integration/payments/all 並加上日期篩選,以取得完整的畫面。
  • 對於財務規劃問題,請合併使用 /api/integration/payments/all 與 /api/integration/finance/costs 以獲得完整檢視。
  • 寫入操作: 將付款標記為已付或續約租約時,一律使用需驗證的端點。進行大量操作時,務必先進行預覽。
  • 大量付款標記: 當使用者說「將所有 3 月付款標記為已付」時,請使用大量按日期標記的端點,而非逐筆呼叫。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

modbender/skill-library-mcp

Paid acquisition strategy, budget allocation, and avoiding common advertising mistakes across platforms

modbender/skill-library-mcp

Complete investment portfolio risk management system. Analyze positions, calculate risk metrics, stress test scenarios, optimize allocations, and generate institutional-grade risk reports — all wit...

modbender/skill-library-mcp

Borrow from Aave via credit delegation. Agent self-funds by borrowing against delegator collateral. Supports borrow, repay, health checks. Works on Aave V2/V3.

modbender/skill-library-mcp

Discover and register autonomous AI agents. Use when: browsing the agent registry, submitting an agent for verification, or embedding agent badges. NOT for: general web search or agent capability analysis.

modbender/skill-library-mcp

Create AI avatar and talking head videos with OmniHuman, Fabric, PixVerse via inference.sh CLI. Models: OmniHuman 1.5, OmniHuman 1.0, Fabric 1.0, PixVerse Lipsync. Capabilities: audio-driven avatars, lipsync videos, talking head generation, virtual presenters. Use for: AI presenters, explainer videos, virtual influencers, dubbing, marketing videos. Triggers: ai avatar, talking head, lipsync, avatar video, virtual presenter, ai spokesperson, audio driven video, heygen alternative, synthesia alternative, talking avatar, lip sync, video avatar, ai presenter, digital human

modbender/skill-library-mcp

AI代码编辑器规则模板集合 - 为Cursor、Windsurf、Claude Code、Cline等AI编辑器提供项目规则配置。适用于需要配置AI编码助手规则的开发者,包含全栈Web、移动端、Vue3+SpringBoot等技术栈模板。

modbender/skill-library-mcp

Generate landing page code from product descriptions

modbender/skill-library-mcp

Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for visuals, Kokoro for voiceover. Types: product demos, testimonials, explainers, social ads, brand videos. Use for: Facebook ads, YouTube ads, product launches, brand awareness. Triggers: marketing video, ad video, promo video, commercial, brand video, product video, explainer video, ad creative, video ad, facebook ad video, youtube ad, instagram ad, tiktok ad, promotional video, launch video

modbender/skill-library-mcp

Generate AI music videos end-to-end. Creates music with Suno (sunoapi.org), generates visuals with OpenAI/Seedream/Google/Seedance, and assembles into music video with ffmpeg. Supports timestamped lyrics (auto SRT), Suno native music video generation, slideshow/video/hybrid modes. Token-based cost tracking per generation.

modbender/skill-library-mcp

Generate AI-powered notes from videos (document, outline, or graphic-text formats)

modbender/skill-library-mcp

The video AI notes tool is provided by Baidu. Based on the video download address provided by the user, it downloads and parses the video, and finally generates AI notes corresponding to the video (a total of three types of notes can be generated: document notes, outline notes, and image-text notes).

modbender/skill-library-mcp

Automated appointment management for beauty salons, clinics, studios, and photo booths. Handles booking requests, calendar sync, conflict detection, reminders, no-show tracking, and waitlist management.

modbender/skill-library-mcp

Bird identification, life list tracking, and trading card generation. Use this skill when the user: sends a bird photo to identify, says "set up my Birdfolio" or "set my region", asks "how's my checklist", asks "Birdfolio progress", asks "how many birds have I found", asks "show my Birdfolio" or "show my life list", asks "what's my rarest bird", or asks "tell me about [bird species]". Handles everything from first-time setup through ongoing life list tracking and visual trading card generation.

modbender/skill-library-mcp

Multi-project task and research management (JSON-first CLI)

modbender/skill-library-mcp

Track stock and crypto portfolios with CLI - real-time prices, P&L, dividend tracking, multiple portfolios

modbender/skill-library-mcp

Track cryptocurrency portfolios with real-time prices, P&L calculations, and allocation analysis. Query Bitcoin, Ethereum, Solana and 10,000+ token holdings.

modbender/skill-library-mcp

加密貨幣Portfolio追蹤 - 支援TRON/ETH/BSC,分析持倉、收益、Gas費用

modbender/skill-library-mcp

Lead strategy with competitive analysis, strategic planning, growth roadmaps, and business portfolio management.

modbender/skill-library-mcp

Create ATS-optimized resumes and CVs with proper structure, metrics, and industry targeting.

modbender/skill-library-mcp

Native video analysis using Google Gemini API. Upload and analyze video files — describe scenes, extract text/UI, answer questions about content, transcribe speech, identify objects and actions. Use when: (1) User sends a video file and wants it analyzed, (2) Video summarization or description needed, (3) Extracting text, UI elements, or information from screen recordings, (4) Answering questions about video content, (5) Comparing multiple videos, (6) Analyzing tutorials, demos, or walkthroughs.

相關技能