はてなブックマーク

先月、ClaudeCodeに追加された「サブエージェント(subagents)」機能を試してみたので、その体験を紹介します。 テストの修正作業を自動化したい、CIでテストが失敗する前に気がつきたい、というのが今回の動機です。 サブエージェントとは? サブエージェントとは、ClaudeCodeがタスクを委任できる、あらかじめ定義されたAIエージェントのことです。 それぞれ独立したコンテキストで動作するため、専門的な処理を任せやすく、再利用や目的別の最適化がしやすいという特徴があります。 サブエージェントの作成 claudeを起動し、コマンドを実行 初期状態ではエージェントは存在せず、「No agents」と表示されます。 今回はテスト自動化の専門家を作成します。 推奨されているClaudeが自動生成したテンプレート定義を使い、あとで必要に応じてカスタマイズする形です。 Generate wi

エスマットでは、コンテナ基盤としてAWS EKSを採用しています。開発者はマイクロサービスの開発・デバッグを行う際に開発用の共通クラスターにTelepresenceを使い開発中のサービスのみを入れ替えて動作検証をおこなっていました。 しかし、Telepresence v2.21以降、OSS版ではpersonal interceptorが削除されたため複数開発者が共通クラスターにTelepresenceで同時に接続することができなくなりました。そのため、代替方法を探す必要が発生しました。いくつかの候補を検討した結果、最終的にmirrordを採用することにしました。 この記事では、Telepresenceからmirrordに移行した経緯を解説します。また、mirrordを実際にどのような設定で運用しているかを紹介します。 Telepresenceとmirrordの比較 私たちのチームが直面して

はじめに 弊社エスマットでのファームウェア開発において、しばらく悩まされていた課題だった技術ドキュメントの整備を AI エージェントの Devin に任せてみました。 結果として、人手で 4 週間と見積もられた作業が、わずか 6 時間のレビュー作業で完了。合計で 1 万行を超える Markdown ドキュメントが作成され、ファームウェアの理解促進と AI コーディング精度の向上という目標を実現できそうなところまできました。 この記事では、Devin を活用したドキュメント整備の具体的なアプローチと、実際の運用で得られたノウハウを共有します。 背景:散在・陳腐化したファームウェアドキュメントの課題 ドキュメントの現状と課題 弊社製品であるスマートマットのファームウェアは、元々外注先で開発されたものを引き継いで開発を続けていました。外注先から引き継いだ時点で体系的なドキュメントは無かったようで

こんにちは、株式会社エスマットでエンジニアリングマネージャーを担当している仙葉です 弊社ではマイクロサービスアーキテクチャを採用しており、システムの柔軟性を高める一方で、横断的な修正が必要になった際に作業量が増大するという課題があります 今回はDevinを利用し、各マイクロサービスに対して効率的に作業を行うための活用方法と、将来的な自動化への展望についてご紹介します 取り組んだタスクの概要 作業内容 DB管理用MSに集められているテーブル定義にカラム、テーブルコメントを追加する 各マイクロサービスの実装やドキュメントを参照し、コメント内容を決定する そのテーブル独自でID以外のにはサンプルデータも記載してもらう 期待する成果物 テーブルスキーマ修正 反映用のAlterTableクエリ作成 このタスクは技術的には難易度が低いものの、複数マイクロサービスを参照し、同様の作業を横展開する必要があ

エスマットでエンジニアをしているpotix2です。最近、 社内の EKS クラスター上に Dify 環境を構築していたときに設定ミスから予想外の問題に遭遇しました。この問題解決に Cline を活用したところ、コードリーディングの効率が大幅に向上し、従来の方法よりも短時間で原因特定ができました。 この記事では、SRE のための Cline 活用法と、実際のトラブルシューティング事例について共有します。 1 分まとめ Cline に実行ログを与えると、関連するコードを素早く特定できる Dify 環境の構築時、複数コンポーネント間のキャッシュ問題を Cline で効率的に解決した SRE こそ Cline を活用すべき、コードリーディングの効率が大幅に向上する Dify でのトラブル:見えない依存関係の謎 Dify は、ノーコード・ローコードで AI アプリケーションを開発できるオープンソース

こんにちは。エスマットエンジニアの金尾です。 皆さんはDevinと働いていてつらい思いをしたことはありますか? 僕はあります。 弊社にDevinがやってきてからしばらく経ちました。チュートリアルとも言われる250ACUは早々に使い切り、今ではプロダクト改善タスクをこなしながらいろいろと運用方法を模索している段階です。 支払い上限分まで働くとその後は一切の活動を停止するDevin。 いち労働者として見習いたい。 本記事では、Devinを使ってみた所感および今後の活用についてまとめたものです。 AIエージェントとしての特徴 以下、二ヶ月ほど使ってみての所感です。 (他と比較すると)遅い Cursorなどの他のAIエージェントと比較すると、Devinの作業スピードは決して速いものではありません。Sessionチャットからその場で都度指示出しすることはできますが、体験としてはあまりよくなく、併走し

エスマットでエンジニアをしているpotix2です。先日、エンジニアリングチームで生成AIアプリケーション開発のハッカソンを開催しました。8名のエンジニアが5チームに分かれ、1日という短期間で様々なプロジェクトに取り組みました。本記事では、その成果と学びを共有します。 ハッカソンの様子 なぜハッカソンを実施したのか 全社的な方針として、業務とプロダクトの両面で生成AIをフル活用していく方向性が示されました。これを受けて、エンジニアリングチームでは生成AIアプリケーション開発に必要な技術的スキルを効率的に習得する必要性に迫られていました。 私たちは既存業務の延長線上ではなく、新規プロジェクトとして技術習得に取り組むことが効果的だと考え、ハッカソン形式での実施を決めました。短期間で集中的に開発することで、生成AIアプリケーション開発の全体像を把握し、必要な技術スタックへの理解を深めることを目指し

Google DriveとLLMで議事録を自動生成する仕組みを作る こんにちは。 株式会社エスマットでSREをしているbiosugar0です。 今回は私が社内向けに構築した Google Driveにアップロードされた音声・動画ファイルからLLMを使って自動的に議事録を生成するシステムを紹介します。Python製です。 数ある会議や電話、インタビュー音源を文字起こしし、要点をまとめる作業は非常に手間がかかりがちです。そこで、Google Cloud Run・Google Workflow・Whisper・gpt-4o などを活用して、書き起こしから最終的な議事録ドキュメントを作成するまでを自動化しました。Googleカレンダー情報の連携やSRT形式による動画連携、フォルダ名による処理分岐など、拡張性を持った仕組みを整えているので、そのポイントを順番に紹介していきます。 システム全体概要 全

この記事は SMat Advent Calendar 2024 の12月25日分の記事です。 こんにちは、株式会社エスマットでエンジニアリングマネージャーを担当している仙葉です アドベントカレンダー最終日です!弊社としては初めての挑戦でしたが、なんとか予定していた通り投稿が実施され完走することができました🎉 今回はアドベントカレンダーの取り組みを振り返りつつ、弊社のアウトプット施策についてお話ししていきたいと思います なぜアドベントカレンダーを始めたのか 弊社では以前からテックブログとZennに記事の投稿を行なっておりました しかし、メンバーの入れ替わりに伴い管理者なども変更されており、今年に入ってから投稿数が減少していました そこで外部アウトプット改善に向けて動き出すにあたり、目をつけたのがアドベントカレンダーです 毎年盛り上がっており、さまざまな記事が投稿されるため読むだけでも大変な

これは SMat Advent Calendar 2024 の12/24分の記事です。 エスマットでエンジニアをしているpotix2です。12/10に、S-Mat Tech Nightと題してIoTエンジニア向けの勉強会を開催しました。この記事では、イベントの様子を紹介しつつ勉強会の運営視点での振り返りを行い、今後同じようにオフラインでの勉強会を開催しようとする方の助けになればと思います。 勉強会開催のきっかけ きっかけは大きく二つあります。一つ目は、エンジニアの採用強化に向けて社外への技術情報発信を強化したいという思いです。もう一つは、センサーデータの扱い方やIoT関連サービスの開発で遭遇しやすい課題について、気軽に話せる勉強会が少ないと感じていたため、IoTエンジニア同士が交流できる場をつくりたいと考えたことです。 実はこの勉強会を企画する前から、「誤差論についての教科書を読んで、気に

これは SMat Advent Calendar 2024 の12/23分の記事です。 はじめに こんにちは、株式会社エスマット エンジニアの hi6okuni です。 最近Reactでテーブルカラム内にオートコンプリート付きのインプットを設置する機会がありました。 オートコンプリートの検索候補は、localStorageやAPIなど、様々なソースから取得するパターンが考えられます。Reactのライフサイクルにおいて、これらの検索候補を複数コンポーネントで同期し管理する場合、ZustandやContext APIといったグローバルステートを利用することが多いのではないでしょうか?(API経由の場合は、APIクライアントのキャッシュ機能を活用するのが一般的かもしれません) 今回のプロジェクトについても「テーブル内のあるカラムで入力された新規ワードは、他のカラムで即座に検索候補として表示される

はじめに これは SMat Advent Calendar 2024 の12/20分の記事です。 株式会社エスマット エンジニアの若林です。 弊社では「SmartMat Cloud」というIoT重量計 x SaaSでモノの流れを可視化するサービスを提供しております。重量計を使えば多くの商品で数量を把握できますが、世の中には重量での数量の把握が適さない商品もあります。 数量を把握できるモノの対象を広げるべく重量以外でもモノの数を把握できないか実験するため、プロトタイプを作ったりして実証実験をしています。今回はArmadilloというIoTゲートウェイを用いてプロトタイプを作った経験をもとに、どうやって作成したかを簡単に説明しつつArmadilloのメリットデメリットや開発時の注意点を紹介します。 Linux+Pythonスクリプトでソフトウェア開発ができるので、Web系のエンジニアの方でもプ

これは SMat Advent Calendar 2024 の12/19分の記事です。 こんにちは、株式会社エスマットにてバックエンドを中心に開発をしています、野島といいます。 私は GoF の Strategy パターンが好きでよく使います。弊社では在庫管理プロダクトを提供しており、その中に「マスタデータをファイルアップロードで更新する機能」があります。この機能の実装に Strategy パターンを利用しています。 本記事では Strategy パターンの概要を簡単に説明した後、パターン適用例としてファイルアップロード処理の実装について共有します。 Strategy パターンの概要 Strategyパターンはアルゴリズムをカプセル化して交換可能にします。 Strategy: アリゴリズムに共通するインターフェイスを定義します ConcreteStrategy: Strategy インター

この記事は SMat Advent Calendar 2024 の12月18日分の記事です。 株式会社エスマット エンジニアの中村です。 今回は現在取り組んでいる弊社のサービスの推奨ブラウザに関する話をしていきます。 現状のブラウザ推奨環境 スマートマットクラウドの推奨ブラウザは現在下記のようになっています。 推奨ブラウザ:Google Chrome、Safari、Firefox 非推奨ブラウザ:Internet Explorer、Microsoft Edge これは数年前に決めたものであり、現状の利用環境に合っていない状態にあります。 この推奨ブラウザは当時の利用率や市場動向、想定されるユーザーの利用環境から策定したもので、PCからの利用を考えて設定したものです。(スマホからの利用は想定していません)WEBブラウザのシェア率1位は2016年頃からGoogle Chromeが1位になり、2

これは SMat Advent Calendar 2024 の12/17分の記事です。 弊社では「SmartMat Cloud」というIoT重量計 x SaaSでモノの流れを可視化するサービスを提供しております。最近お客様がスムーズにオンボーディングできるように、スマホのweb appのプロトタイプを作っております。当時のスプリントのゴールは商品の初回登録の時はスマートマットのシリアル番号や製品バーコードを読み取って検索するプロトタイプを狙いました。 バーコードリーダーはnpmのzxing-wasmがデファクトスタンダードでしたがスマートマットのシリアル番号はOptical Character Recognition(OCR)が必要でした。 OCR in the browser OCRはtesseract.jsでしょう?と思いましたが、ocrsというプロジェクトが気になりました。 ocrs

こちらは株式会社エスマットのSMat Advent Calendar 2024 16日目の記事になります。 記事概要 Gormは洗練されたAPIを持つ大変優れたORMなのですが、いろんな関数の引数の型がinterface{}になっており、静的型付きコンパイル言語のライブラリとしてはやや微妙なところがあります。 GormのコードジェネレータであるGenを使うとinterface{}がなくなるらしいので、APIや定義などを確認したいと思います。 基本的なことは書きませんので、公式ドキュメントやほかのかたの記事をご覧ください。 ドキュメント: https://gorm.io/gen/ GoのORM決定版 Genをはじめよう: https://qiita.com/muff1225/items/f660270694f29597df22 作成されるもの スキーマから以下のものが生成されるようです。なお

この記事は SMat Advent Calendar 2024 の12月13日分の記事です。 こんにちは、株式会社エスマットでSREをしているbiosugar0です。 2024年9月、GitHub Copilotの機能を拡張する「GitHub Copilot Extensions」のパブリックβ版が全ユーザー向けに公開されました。 これにより、個人やサードパーティの開発者がVS Codeなどで独自のAIエージェント(以下、エージェント)を開発できるようになりました。 GitHub Copilotは定額で使えるうえに拡張性も追加されたのは嬉しいアップデートですね。 この記事では、Cloudflare WorkersとTypescriptを使って、GitHub Copilot Chatのエージェントを実装する方法を紹介します。Cloudflare Workersを使うことで、サーバー構築のコス

これは SMat Advent Calendar 2024 の12/12分の記事です。 株式会社エスマットでエンジニアをしている potix2です。 私たちの開発環境はこれまでIPアドレスによるアクセス制限を採用していましたが、よりセキュアかつ柔軟なアクセス管理を実現するため、Cloudflare Accessの導入を決定しました。この記事では、その移行プロセス、遭遇した課題、および解決策について詳しく説明します。 なぜCloudflare Accessを導入したのか 従来のIPアドレスに基づくアクセス制限は、その単純さから選ばれていましたが、最近のオフィス移転に伴い、固定IPアドレスの利用が不可能になりました。この変化は、セキュリティとアクセシビリティのバランスを再考させる重要な要因となりました。特に以下のような課題がありました。 固定IPアドレスの喪失:オフィス移転により、以前に利用し

この記事は SMat Advent Calendar 2024 の12月11日分の記事です。 こんにちは。エスマットエンジニアの金尾です。 皆さんはリポジトリパターンでつらい思いをしたことはありますか? 僕はあります。 本記事はそもそもリポジトリパターンとはどういう実装パターンなのかについて検討した内容をまとめたものです。なお文中に出てくるコードはGo言語を前提としています。 リポジトリパターンとは リポジトリパターンとは、ドメインモデルのデータ処理をアプリケーションの他の部分から分離する実装パターンです。 対応するドメインモデルのCRUDや集計のメソッドを提供し、データストレージに関する処理をカプセル化します。 各クライアントは、データストレージのマッピング処理を考えずにUserモデルを利用できる なぜリポジトリパターンを使うのか リポジトリパターンを使うことによって以下のメリットが期待

この記事は SMat Advent Calendar 2024 の12月10日分の記事です。 こんにちは、株式会社エスマットでエンジニアリングマネージャーを担当している仙葉です 前回の記事から期間が空いてしまいましたが、今回も開発生産性を向上させるための取り組み状況をご紹介していきます! 昨年からの変化 とりあえずFindyTeam+から直近半年の数字持ってきました 全体的に向上していてとてもいい感じ。。。! 弊社では昨年の段階でレビューやデプロイに関しての課題感はほぼ無くなっており、これ以上無理に数値にこだわっても仕方ないよねという共通認識ができていたので、今年は数値を安定させつつ新しい取り組みを模索する1年だったと思います FindyTeam+さんには引き続きお世話になっており、毎週エンジニア全体で行なっている定例に直近の数値を確認するアジェンダを追加し、そこでアラート検知的な役割で活

この記事は SMat Advent Calendar 2024 の12月9日分の記事です。 はじめに 弊社エスマットの開発チームでは、新規機能の開発においてデザインスプリントを参考にした手順で機能開発に着手しました。オフラインで集まったメンバー7人全員がそれぞれ意見を出すことで様々な視点から解決策や問題点を出すことができ、短期間でプロトタイプを作成することに成功しました。 今まで出なかったような斬新な意見や、試したいアイディアを共有する機会となり、スムーズに開発に着手できた点が非常に有意義でした。 今回のプロセスでは、1日目をオンラインで、2日目をオフラインで実施しました。 1日目 オフラインで集まる前日までに、オンライン会議を通じて以下の内容を共有し、課題に対する理解を深めました。 課題が生じるまでに至った経緯 課題について詳しい人からのヒアリング 現在の状況 疑問を出す 実現したいこと

これは SMat Advent Calendar 2024 の12/6分の記事です。 弊社では「SmartMat Cloud」というIoT重量計 x SaaSでモノの流れを可視化するサービスを提供しております。最近オンボーディング改善のためスマホのweb appを作っております。 はじめに 先日、あいまい検索の機能をプロトタイプ作ってみました。手法は深く考えずに「レーベンシュタイン距離」のベースで作ったが、npm パッケージ(fastest-levenshtein)にもありましたので差し替えしました。しかし、「fastest」ってどれぐらいか気になり、benchmarkのツールを試しずつ、調べてみました。 JSのbenchmarkは現実の現状は何? Deno 2のリリースノートにはbenchコマンドがあり、mitata 1.0のリリースノートにはオンラインで良い議論が始まっていたので、深く

これは SMat Advent Calendar 2024 の12/5分の記事です。 株式会社エスマット エンジニアの若林です。 弊社では「SmartMat Cloud」というIoT重量計 x SaaSでモノの流れを可視化するサービスを提供しております。弊社で働いているエンジニアはほとんどがWebアプリエンジニアで、組み込み系のソフトエンジニアは現在私しかおらず少し寂しさを感じています。 そこで組み込み系の技術についてWebアプリエンジニアにも触れてもらうために、今回はRTOSに関して記事を書いてみました。同じような会社は他にもあると思うのでIoTを取り扱っているエンジニアの方はぜひご覧ください。 RTOSとは RTOS(Real-Time Operating System)とは、時間的な制約がある処理を実行するための機能や特性を備えたOSのことです。 家電やIoTデバイスなどの組み込み機

これは SMat Advent Calendar 2024 の12/4分の記事です。 はじめに こんにちは、株式会社エスマット エンジニアの hi6okuni です。 今回は、OpenAPI Specification(以降、OpenAPIと呼ぶ)からTypeScriptの型自動生成の仕組みをサクッと作った時の振り返りです。 型の自動生成自体はすでに多くの事例や記事が公開されていますが、本記事では特にマイクロサービスアーキテクチャにおいて「クライアントサイド(Next.js)とマイクロサービス(Go)の間にBFF(tRPCサーバー)が存在する」という構成に焦点を当て、実装例と得られた知見を紹介します。 特に以下のような課題をお持ちの方に参考になれば幸いです。 複数のマイクロサービスのOpenAPIから型を自動生成したい BFFレイヤーでの型定義の保守コストを削減したい tRPCサーバーとマ

これは SMat Advent Calendar 2024 の12/2分の記事です。 こんにちは、株式会社エスマットにてバックエンドを中心に開発をしています、野島といいます。 弊社では在庫の重量を計測し、在庫数を推定する機能を有する在庫管理プロダクトを提供します。なにかを計測する場合、計測値は誤差を含み、この誤差をどう扱うかという課題があります。弊社の重量を測るスマートマットも計測値に誤差を含み[1]、誤差の扱いが課題として存在します。 本記事では誤差による影響を簡単に説明し、データに最頻値フィルタを適用する実験を行います。 誤差による影響 誤差が在庫数の推定に影響を与える一例として、以下のグラフを示します。 このグラフでは、赤い破線が真の在庫数(真値)を表し、オレンジの線が計測値を基に推定した在庫数(推定値)を表しています。誤差を含む重量計測値をシミュレートし、在庫1つあたりの重量で割る

前書き どうも、スマートショッピングでプログラマーをやっている桑島です。 昨年末頃からスクラム運用にNotionを使い始めました。まだまだ試行錯誤中ですが、現在の利用方法などについて社内共有もかねて記事としてまとめたいと思います。 弊チームのスクラムのすすめかたについて 社内でもチームごとにスクラムの進め方がちがうので、私のいるチームが普段どうスクラム開発を行っているかまず説明します。 社内のエンジニアチームですが、いわゆるSaaSのロードマップ開発を行っているチームが3つ、ハードと組み込みソフトウェアを開発しているチームが1つ、あとSREチームが存在しています。 その中で私はマッハ(Mach)というロードマップ開発を行うチームに所属しています。 チームメンバーはエンジニアが3人、PdM、デザイナーとなっており、PdMとデザイナーは他チームとの兼任になっています。 開発の流れですが、基本的

要旨 コメントを適切に記述することは、特にインターフェイス(クラスやメソッド)において重要です。これにより、直感性が高まり、抽象化が十分に行われているかを確認する手助けになります。そのため、コメントはソフトウェア設計プロセスの重要な一部と位置づけられます。 2種類のコメントタイプ まず、コメントを2種類に分類します。 1️⃣ コードをより詳細化するコメント(lower-level comment) 2️⃣ コードをより抽象化するコメント(higher-level comment) どちらも必要なコメントとしつつ、本書では後者のコメントをより重視しています。 1️⃣ コードを詳細化するコメント(lower-level comment) 変数名などに残すタイプのコメントで、宣言した対象の単位や境界値、null許容などの詳細を明示することで、コードの正確性を高めます。こちらのタイプのコメントも必

こんにちは、バックエンドを中心に開発をしています、野島といいます。 ソフトウェアテスト自動化カンファレンス2023に「マイクロサービスアーキテクチャへのIntegration Test導入のすゝめ」というお題で登壇しました。 そちらで発表した内容を記事にしつつ、当日話しきれなかった内容についても書きます。 発表は下記の内容を話しました。 Integration Testの導入を決意した背景にあった課題 Integration Testの導入/運用での工夫 Integration Testを導入して得られたメリット まとめ 本記事では、Integration Testを以下の定義で扱います。 マイクロサービスが依存する外部コンポーネントをモック化せずに行うAPIテスト。 外部コンポーネントとは、具体的にはデータストア、外部サービス、テスト対象が依存するマイクロサービス、などを指します。 テス