kelly-invest-stock

Kelly Invest Stock

コンパクトな戦略実験デスクを運営します。最初の画面の中心には大きな戦略テーブルを配置します。テーブルには簡潔な投資仮説、成熟度ラベル、口座 NAV、リターン、ベンチマーク、ドローダウン、現金、仮想ポジションを表示します。行を開くと、戦略と台帳の詳細をすべて確認できます。

必須の依存関係

アプリを変更する前に：

1. $kelly-app-skill-creator を読み、プロダクトの動作、レスポンシブ UI、正規のローカル content/kelly-invest-stock-app/ アーティファクトに関する指示に従います。
2. $busabase を読み、接続、対象 Space、ChangeRequests、レビュー、マージに関する指示に従います。
3. $busabase-app-creator を読み、リソースのモデリング、AirApp ランタイム、セキュリティ、検証、デプロイに関する指示に従います。
4. 市場データの取り込みを変更する前に references/stock-sdk.md を読みます。

依存関係を利用できない場合は、安全なローカルアーティファクトの作業は続行できますが、利用できないデプロイまたは Busabase 操作の前に停止してください。2 つ目の永続バックエンドは決して作成しないでください。

プロダクトの境界

• 対象は中国本土の A 株に限定します。6 桁の株式コードを保持し、中国語の証券名を主な識別情報として表示します。すべての仮想口座、価格、時価、損益、ポートフォリオ合計には CNY を使用します。
• 口座、ポジション、リターン、ステージ、回帰テストの結果はすべて仮想のものにしてください。Futu やその他の証券会社には接続せず、注文 UI を作成せず、取引 API を呼び出さないでください。
• 各戦略には仮想口座を 1 つだけ割り当て、新しい戦略のデフォルトはすべて L1 にします。
• L1、L2、L3 は戦略全体に対する手動ラベルとして扱い、個別の株式には適用しません。
  • L1：デフォルトの基本的な観察段階。
  • L2：手動で指定された高度な観察段階。
  • L3：手動で指定された高確信度の観察段階。
• invest-ui における L2/L3 のライブ取引上の意味をコピーしないでください。このスキルでは、ラベルを変更しても執行モード、口座種別、資金は変わりません。
• 投資仮説、根拠、前提、確信度、無効化条件はそれぞれ分けてください。ラベルやスコアは推奨ではありません。
• 審査済みの信頼された実行でのみ、バージョンを厳密に固定した [email protected] を使用してください。ブラウザーコードから公開市場データを取得してはいけません。

データとモード

• デフォルトでは、永続データのソースとして Busabase を使用します。通常の呼び出しや URL によって、Demo に暗黙のうちに切り替わってはいけません。
• Demo を開く、または更新するようユーザーが明示的に依頼した場合のみ、Demo に切り替えます。Demo データは決定論的で、明確にラベル付けされ、永続化されません。
• Buffett、Munger、段永平、Peter Lynch、Howard Marks、Fisher、Graham、Li Lu、Templeton、Soros などを参考にした、投資家スタイルの Demo 戦略を 10 件用意します。すべての Demo バスケットは、明確にラベル付けされた A 株の例で構成し、戦略ごとに名目口座額を CNY 1,000,000 に固定します。スタイルの再現例であることを明記し、実際の保有銘柄、支持、または現在の投資助言であると示唆しないでください。
• 永続状態の読み書きには busabase-sdk を使用します。ステージの変更は、戦略レコードの status フィールドを更新する records.changeRequest と、人間による理由および口座スナップショットを含む日付付き承認レコードを使います。ステージの変更をブラウザーのストレージやローカルファイルに永続化しないでください。
• Busabase レコードのページサイズはプロバイダー内で API のサポートする最大値以下にします。nextCursor が尽きるまで処理を続け、Base 宣言に転送レベルのページネーションを記述したり、1 ページを全データとみなしたりしないでください。
• 決定論的な学習用シードを提供できるのは、Busabase ワークスペースが完全に空の場合のみです。Base ごとにレビュー可能な一括 ChangeRequest を 1 件送信し、自動マージは行いません。マージするかどうかは、ユーザーまたは Space のレビュアーが決定します。

コアリソース

1 つのアプリケーションフォルダー内に、アプリケーションが所有する Base を 5 つ維持します。

• strategies：名称、キー、分類、status、投資仮説、選定ルール、 無効化ルール、レビュー頻度、次回レビュー時刻、ベンチマーク、確信度。
• ledger-accounts：戦略ごとに 1 つの仮想口座。名目資本、NAV、 現金、ベンチマーク収益率、最大ドローダウン、更新時刻、収益率の基準日を記録します。
• ledger-positions：仮想数量、取得価格、参照価格、市場価値、比率、価格ソース／時刻、 戦略キー、6 桁の A 株コード、中国語の証券名。
• strategy-backtests：日付付きの戦略レベルのレポート。開始／終了期間、 手法、対象範囲、ベンチマーク、総収益率、CAGR、ボラティリティ、シャープレシオ、 最大ドローダウン、ベンチマークに対する収益率、バイアス／ソースに関する注記を記録します。
• strategy-reviews：日付付きの調査ソース、ソースの鮮度、裏付けとなる証拠と反証、 口座のスナップショット、人手による段階の判断、レビュー担当者、理由、 関連する ChangeRequest ID を記録します。

新しい空のワークスペースは、Busabase の構造 ChangeRequest を 1 つ使って遅延プロビジョニングし、Folder を再読み込みして、検証済みの具体化 ID のみを使用します。所有する古いスキーマの場合は、宣言済みの追加フィールドだけをレビュー可能なフィールド ChangeRequest として提出し、承認を待ってからリソースのメタデータを更新します。順序が変更されたフィールド、内容が変更されたフィールド、または互換性のないフィールドは拒否します。この宣言の対象外にある、従来のアプリケーション所有リソースは無視し、暗黙的に削除したり引き継いだりしないでください。

運用ループ

調査

評価を始める前に、戦略の投資仮説、選定ルール、無効化ルール、ベンチマーク、レビュー頻度、次回レビュー時刻、仮想口座を定義します。調査ソース、ソースの日付、裏付けとなる証拠、反証、データの鮮度を、日付付きのレビュー記録に残します。

計画

次回のレビューに必要な証拠を明示します。新しい戦略は L1 のままにします。L2／L3 への変更は、人間による成熟度の判断として扱い、自動昇格や取引の許可として扱わないでください。

実行

レビュー済みの調査内容の更新、仮想台帳の記録、マウス操作による手動の段階設定を許可します。昇格の前に、戦略ルール一式、基準日を持つ口座 1 つ、日付付きの調査証拠、価格情報の出所、照合済みの NAV を必須とします。段階を変更するたびに、人間による理由と確認を必須とします。永続的な段階変更は Busabase ChangeRequest を通じて行い、承認タイムラインの記録を作成してから、具体化後の正規レコードを再読み込みします。

振り返り

仮想収益率、ベンチマーク、最大ドローダウン、ポートフォリオ全体への寄与を比較します。戦略のルールを変更する前に、投資仮説とプロセスのどちらが失敗したのかを記録します。

UI 契約

• Strategy、L1、L2、L3、Regression、Help & Settings を配置した固定デスクトップサイドバーを使用します。Virtual Ledger タブを別途追加しないでください。
• Strategy ルートには、戦略の概要と台帳の実態を統合した、全幅の大きなテーブルを配置します。行全体をクリックすると Strategy Detail が開くようにします。
• Strategy Detail の上部に、手動切り替え式の L1/L2/L3 セグメントコントロールとコンパクトなパフォーマンス概要を配置します。その下には、次の順序で共有可能なハッシュルートタブを配置します：组合持仓、研究与审批、策略逻辑、回测表现。
• デフォルトで 组合持仓 を開きます。口座の NAV／資本／現金／損益、投資済み資産と現金の配分を表示し、次の項目を含む全幅テーブルを配置して、詳細画面の中心とします：中国語の銘柄名、6 桁のコード、数量、仮想取得価格、参考価格、仮想時価、ポートフォリオ比率、仮想損益。現金は概要に隠さず、ポートフォリオの一部として常に見えるようにします。
• L1/L2/L3 ルートでは、銘柄ではなく戦略を絞り込みます。
• デフォルトの戦略テーブルは、次回レビュー時刻の順に並べ、レビュー日が未設定または期限超過のものを先頭にします。デフォルトのワークフローをリターンや信頼度で順位付けしないでください。
• 研究与审批 には、日付付きの肯定的証拠と反証、情報源の来歴、鮮度、各ステージの判断、人間による理由、レビュアー、スナップショット指標、ChangeRequest ID を表示します。Demo の承認は全体更新時にリセットされることを明記します。
• デスクの読み込み後は、Strategy／L1／L2／L3 の移動をメモリ内の戦略フィルターとして扱います。サイドバーとワークスペースヘッダーの DOM を維持し、戦略のメインコンテンツのみを更新してください。これらのルート変更で Busabase を再取得したり、ページ全体の読み込み状態を表示したりしないでください。
• Regression は、invest-ui に準拠した日付付きの戦略バックテストテーブルとします。レポート日、開始日／終了日、期間ラベル、手法、カバレッジ、総リターン、CAGR、ボラティリティ、Sharpe、最大ドローダウン、ベンチマーク相対リターンを表示します。事後分析に関する警告は常に見えるようにします。現在の仮想ポートフォリオへの寄与（strategy P/L / total nominal capital）と除外ケースは、明確に分けた補助セクションに表示します。過去の観測値に裏付けられた、日付付きの保存済みレポートがない限り、バックテストや過去の指標を捏造しないでください。
• 信頼できる過去の市場データを使ったワークフローが実際に利用可能な場合を除き、再実行アクションを表示しないでください。保存済みレポートは閲覧可能なデータであり、実行可能なバックテストエンジンではありません。
• モバイルでは、共通の画面外サイドバー、独立した詳細ルート、固定表示の戻るアクションを使用し、幅が 390px または 360px のときにページが横にはみ出さないようにします。
• 仮想取引のみという境界を常に明示します。このアプリ内のどこでも、L2 を Futu のペーパートレード、L3 を実取引と説明しないでください。

指標ルール

• ポジション損益は quantity * (latest reference price - virtual entry price)、口座リターンは NAV / nominal capital - 1 で計算します。
• 口座の基準日を、名目資本に対するパフォーマンスの開始日として扱います。基準日または株価の情報源の来歴が欠落している場合、リターンを比較可能なものとして比較、順位付け、集計しないでください。指標が欠落している場合はゼロではなく、利用不可と表示します。
• 口座ごとの NAV を現金とポジションの時価の合計と照合します。不一致がある場合は、昇格を許可する前に警告します。
• ポートフォリオ全体のリターンは、口座 NAV の合計と名目資本の合計から計算します。
• 回帰分析スナップショットの寄与度は strategy account P/L / total nominal capital で計算し、除外ケースは残りの口座から計算します。
• 日付付きバックテストレポートを並べ替えたり比較したりする前に、レポート日、期間の開始日／終了日、手法、カバレッジ、ベンチマークがそろっていることを確認します。
• 戦略を順位付けする前に、同じ期間とベンチマークで比較します。
• Demo の観測値は固定し、日付を付けます。ライブデータとして提示しないでください。
• 口座とポジションの金額は CNY で表示します。銘柄名は中国語で先に表示し、6 桁のコードは補助的な識別情報として残します。

完了条件

次の条件を満たした場合にのみ完了とします。

• pnpm --dir content/kelly-invest-stock-app dev のサポートが維持され、決定論的なチェックに合格すること。
• 戦略の概要と詳細、L1／L2／L3 戦略フィルター、手動のステージ設定、Regression がデスクトップとモバイルで動作すること。
• すべての戦略に仮想口座が 1 つあり、明示的な選択ルールと無効化ルールがあること。
• 5 つのリソース宣言、加算型スキーママイグレーション、遅延プロビジョニングがフィクスチャーテストに合格すること。
• 調査の根拠と手動承認が Busabase に永続化され、理由と口座スナップショットが戦略のタイムラインに表示されること。
• 通常モードでは Busabase を使用し、Demo は明示的かつ決定論的で、ラベルが表示されること。
• 証券会社との連携経路、実資金を扱うステージ、取引アクション、個人に合わせた投資に関する主張が存在しないこと。
• 利用可能な依存関係スキルのデプロイと実データのチェックに合格すること。

停止条件

対象の Space が曖昧な場合、閲覧者に権限がない場合、所有権を確認できない場合、古いレコードが上書きされる場合、または依頼が証券会社での執行や資金移動に踏み込む場合は、重大な Busabase の変更を行う前に停止してください。