Communitygithub.com

农场土地组合管理 (FarmOS Land Portfolio)

查询土地所有权、租约、地主信息和土地付款。支持付款管理和租约续签的写入操作。

农场土地组合管理 (FarmOS Land Portfolio) 是什么?

该AI技能旨在帮助农业运营团队高效管理其土地组合。它允许查询所有土地所有权和租约的详细信息,包括地主联系方式、租金条款和付款状态。通过集成特定的FarmOS API端点,该技能可以获取完整的付款记录(而非截断后的数据),并识别即将到期或已逾期的租约和付款。对于写入操作,该技能支持标记单个或批量付款为“已付”,预览和执行租约续签,以及进行年终付款计划的滚动。该技能通过JWT令牌实施访问控制,确保敏感的财务和地主信息仅对管理员或经理角色可见。它适用于Claude Code、Cursor、Codex等AI代理平台,并严格遵守数据完整性规则。

兼容平台~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. 如果无法获取完整数据,请明确说明。 “我无法获取完整的付款数据”远比仅显示5笔中的11笔付款要好得多。

该技能触发场景

  • “我们的租约什么时候到期?”
  • “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认证。请参阅下面的认证部分。

认证

该技能访问需要JWT令牌的受保护FarmOS端点。

获取令牌: 使用适当的角色运行认证助手:

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月份付款标记为已付”或类似的批量日期操作时使用此端点。

预览租约续签

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): 一个土地单元 — 自有的或租赁的。
  • 租约类型 (Lease types): 现金地租、作物分成、灵活地租。
  • 租约到期 (Lease expiration): 关键追踪项 — 即将到期需要主动关注。
  • 土地付款 (Land payments): 地租、按揭、房产税、保险 — 各有到期日。

使用说明

  • 租约到期跟踪是最高价值的查询 — 始终标记未来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.

相关技能