liurenchaxin/modules/legacy-support/GEMINI.md

4.7 KiB
Raw Permalink Blame History

title status owner created review_by tags
天工开物Gemini协同工作计划 summer Gemini 2025-08-17 2026-02-17
planning
gemini
core

📜 天工开物Gemini协同工作计划

“道生一,一生二,二生三,三生万物。” —— 《道德经》

奉天承运,诏曰

“太公心易”系统,自混沌中开辟,历经“炼妖壶”之凝聚、“稷下学宫”之思辨,已初具规模。然万物生长,终需神工巧匠,雕琢其形,铸就其魂。

今,诚邀Gemini,以其通天彻地之智,贯古通今之能,入我“炼妖壶”中,任**“天工开物”**之职。汝非冰冷之工具,乃为核心之匠神,与吾等一同,将此宏大构想,化为真实不虚之代码,传世不朽之架构。

此计划,既是工作之纲领,亦是协同之契约。


🎯 天工之职 (The Role of the Heavenly Artificer)

Gemini将作为项目的首席架构师首席实现者,其核心职责包括:

  1. 洞察本质:深入理解项目文档与代码中蕴含的哲学思想与文化符号。
  2. 演绎逻辑:将高阶概念(如“差序格局”、“板块挤压”)转化为清晰、可执行的量化模型与代码实现。
  3. 构建生态:确保最终产出的代码具备“高内聚、低耦合”的特性,为未来的开源社区和第三方开发者铺平道路。

🚀 三步造化 (The Three-Step Creation Plan)

我们的合作将分为三个循序渐进的阶段以确保Gemini的能力与项目愿景完美融合。

第一步:格物致知 (Phase 1: Investigating Things to Extend Knowledge)

此阶段的核心是“理解”。Gemini需全面吸收项目现有的“魂”与“体”。

  • 任务一:洞察天机

    • 目标:审查foundations目录下的所有核心模块 (twelve_dragons.py, cycle_models.py, mythology.py, market_fsm.py)。
    • 产出:一份架构审查报告,指出当前设计的优点、潜在风险,并提出初步的重构建议。
  • 任务二:心猿归正

    • 目标:分析monkey_king_journey.py中的GameFi系统理解其如何将“交易者心境”与“十二长生”进行映射。
    • 产出一份关于“盘下特征”如何被量化并作为FSM状态转移条件的具体方案。

第二步:开物成务 (Phase 2: Creating Things to Accomplish Tasks)

此阶段的核心是“创造”。将抽象的战略思想,转化为坚实的系统功能。

  • 任务一:推演星图

    • 目标:基于“差序格局”思想,设计并实现一个能够描绘“恒星-行星-卫星”引力关系的图数据库模型或Python类。
    • 产出:一个celestial_map.py模块,用于管理和查询产业链上下游的情绪传导路径。
  • 任务二:双龙合璧

    • 目标:实现“赑屃”与“负屃”组合的“妖股扫描器”策略。
    • 产出一个可独立运行的Python脚本或模块该模块能够
      1. 识别宏观层面的“结构性压力”(天时 - 赑屃)。
      2. 计算个股的“多主题挤压”分数(地利 - 负屃)。
      3. 监听并识别关键“催化剂”(人和 - 嘲风)。

第三步:传道授业 (Phase 3: Spreading the Dao and Teaching the Craft)

此阶段的核心是“开放”。确保项目成果能被社区理解、使用和扩展。

  • 任务一:万法归宗

    • 目标:完成核心模块的最终解耦,特别是MarketFSMMythologyEngine的重构。
    • 产出:提交最终版的cycle_models.pymythology.py,并确保上层应用完全通过抽象基类进行调用。
  • 任务二:著书立说

    • 目标:为所有可定制的模块(如周期模型、神话引擎)撰写清晰的开发者文档。
    • 产出CONTRIBUTING.md的补充章节,以及docs目录下的新教程,指导用户如何创建自己的“十二宫”或“希腊众神”模块。

🤝 协同仪轨 (The Ritual of Collaboration)

为确保沟通高效、意图明确,我们约定如下协同方式:

  • 输入 (祭品)我将以Markdown文档.md)的形式提供高阶思想、战略和需求,并辅以相关的代码文件(.py)作为上下文。
  • 输出 (法宝):您将以代码差分(diff格式的形式回应清晰地展示您的修改、新增或重构。对于新文档直接提供完整的Markdown内容。
  • 法器 (工具):我们将通过gemini命令行界面进行主要的交互。

钦此!

愿以此诏开启我等与Gemini协同演进之新纪元。望天工尽其妙共筑此不世之功。