[backend]構成・内容の評価プロンプトとAPI仕様書の例からフィラートークンを外す

オープン初心者向け

#219 2026年8月30日に作成コメント 0 件リアクション 0 件担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度: 2/5
見積もり時間: 1〜3時間
初心者へのやさしさ: 86/100

issue の種類: バグ
明瞭さ: 明確に書かれている
活発さ: 活発
技術スタック: python
領域: backend, documentation

調査の方向性

backend/app/services/llm.py を読み、evaluate_interview() の system prompt を特定してから、documents/backend/API仕様.md にある関連する turns[].content の例を確認してください。古くなった filler-token に関する文言を削除し、filler tokens を含まない例に更新してください。提供されている docker compose unittest discovery コマンドを実行してください。prompt と API ドキュメントが filler tokens を含まない入力の挙動と一致し、既存のテストがパスすれば完了です。

索引モデルが issue の本文から書いたものです。

説明

種別: 実装 — コードを書き、検証してから PR を出す。

目的

評価APIの turns[].content がフィラー除去済みテキストになる仕様変更（#218）に合わせ、構成・内容を評価するLLMへのプロンプトと、正本であるAPI仕様書の記載を実態に合わせる。

現行の backend/app/services/llm.py の evaluate_interview() は、システムプロンプトで「%で囲まれた語（例: %えー%）は文字起こしが検出したフィラー（言い淀み）です」とLLMに明示し、フィラートークンを言い淀みとして解釈させた上で構成・内容のコメント・アドバイスを生成させている。documents/backend/API仕様.md の turns[].content 例もフィラートークン付きの文字列になっている。#218 でフロントエンドが常にフィラー除去済みテキストを送るようになると、このプロンプトの一文とAPI仕様書の例は実態と食い違う。

完了条件

backend/app/services/llm.py の evaluate_interview() システムプロンプトから「%で囲まれた語（例: %えー%）は文字起こしが検出したフィラー（言い淀み）です。」の一文を削除する
documents/backend/API仕様.md の turns[].content 例（該当箇所）をフィラートークンを含まないテキストに更新する
既存のバックエンドのテストが変更後も成功する

やらないこと

フィラー数・話速の算出ロジック（filler_count 等）の変更
フロントエンドの変更（#218 で対応）
/interviews/chat 側のプロンプト・仕様変更

触る範囲

backend/app/services/llm.py
documents/backend/API仕様.md
関連テスト

検証方法

docker compose build api
docker compose run --rm --no-deps -e SEED_DEV_USER=false -e JWT_SECRET_KEY=test-secret api uv run --frozen python -m unittest discover -s tests

前提・依存

関連Issue: #218 — 評価APIへ送るcontentを常にフィラー除去済みにする。着手順序はどちらが先でも支障ないが、対で完了させることが望ましい

未決事項

なし。

参考

バックエンド API 仕様 — POST /evaluations の turns[].content
評価仕様 — 構成・内容はLLMが定性評価する項目

主要言語: HTML
スター: 1
フォーク: 0
平均マージ: 1時間 19分
マージ済み PR（30日）: 76

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

はじめの一歩

issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
リポジトリをフォークし、ブランチを切って変更します。
issue 番号を参照したプルリクエストを送ります。

study-basic-hackathon/hanasu のほかの issue

[frontend]評価APIへ送るcontentを常にフィラー除去済みにするオープン

難易度 2/5 1〜3時間初心者へのやさしさ 88/100

study-basic-hackathon/hanasu#218 · 2026年8月30日に作成
[frontend]評価結果から回答方式の表示を削除するオープン

種別: 実装

難易度 2/5 半日初心者へのやさしさ 88/100

study-basic-hackathon/hanasu#211 · 2026年8月29日に作成
[frontend]評価履歴一覧のチュートリアル表記を「（チュートリアル）」に変更するオープン

種別: 実装

難易度 2/5 1〜3時間初心者へのやさしさ 84/100

study-basic-hackathon/hanasu#210 · 2026年8月29日に作成
[backend]評価履歴を削除するDELETE APIを追加するオープン

種別: 実装

難易度 2/5 1〜3時間初心者へのやさしさ 90/100

study-basic-hackathon/hanasu#207 · 2026年8月29日に作成
[infra]デプロイ済みAWSリソースを全削除して継続課金を停止するオープン

難易度 4/5 3〜5日初心者へのやさしさ 25/100

study-basic-hackathon/hanasu#227 · コメント 3 件 · 2026年9月6日に作成

study-basic-hackathon/hanasu の issue をすべて見る

似ている issue

`Array.initialize` and `Array.repeat` throw on a negative count オープン

難易度 2/5 1〜3時間初心者へのやさしさ 82/100

gren-lang/core#167 · 2026年9月25日に作成
fix(pg-meta): schemas.update and schemas.remove DO blocks fail when a name contains "$$" オープン

external-issue to-triage

難易度 2/5 1〜3時間初心者へのやさしさ 88/100

supabase/supabase#50882 · 2026年9月24日に作成
wkt: `WKTFieldMask.paths` is an immutable `public let paths: [String]` with no default `init(paths: [String] = [])` or `.with(_:)` helper, preventing in-place mutation オープン

難易度 2/5 1〜3時間初心者へのやさしさ 78/100

googleapis/google-cloud-swift#1151 · 2026年9月24日に作成
SqliteSaver.list(filter=...) silently misses nested metadata values containing non-ASCII text オープン

external

難易度 2/5 1〜3時間初心者へのやさしさ 65/100

langchain-ai/langgraph#9074 · コメント 1 件 · 2026年9月24日に作成
Correct FileCitationBody.index documentation to describe its position in output text オープン

documentation specification

難易度 1/5 1時間未満初心者へのやさしさ 90/100

openai/openai-openapi#584 · 2026年9月24日に作成

Backend & API Design の issue をもっと見る