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

Open Beginner friendly

#219 opened on Aug 30, 2026 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty: 2/5
Estimated time: 1-3 hours
Newbie friendliness: 86/100

Issue type: Bug
Clarity: Clearly specified
Activity status: Active
Tech stack: python
Domain: backend, documentation

Research direction

Read backend/app/services/llm.py and locate evaluate_interview()'s system prompt, then inspect the relevant turns[].content example in documents/backend/API仕様.md. Remove the obsolete filler-token wording and update the example without filler tokens. Run the provided docker compose unittest discovery command; done means the prompt and API documentation match the filler-free input behavior and existing tests pass.

Written by the indexing model from the issue text.

Description

種別: 実装 — コードを書き、検証してから 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が定性評価する項目

Dominant language: HTML
Stars: 1
Forks: 0
Avg merge: 1h 19m
Merged PRs (30d): 76

Contributor guide

No contributing guide indexed for this repository

First steps

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.

Similar issues

[Bug]: control_ui.show_thinking = false does not stop the live reasoning stream, so thinking events and done.reasoning_content still reach the web UI Open

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

use-agent-os/agent-os#3276 · Opened Sep 21, 2026
Refactor traits.rs so that it is only traits Open

good first issue refactor

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

bcgit/bc-rust#148 · Opened Sep 21, 2026
[6.x]: "Cannot use object of type stdClass as array" loading Users index (regression of #19182) Open

Difficulty 1/5 Under an hour Newbie friendliness 90/100

craftcms/cms#19672 · 1 comment · Opened Sep 21, 2026
gate (GO): setLeverage intermittently fails with INVALID_SIGNATURE — signed Rawencode(query) and sent Urlencode(query) can differ in key order Open

Difficulty 2/5 1-3 hours Newbie friendliness 86/100

ccxt/ccxt#30561 · Opened Sep 21, 2026
[Perf]: the capability epoch counts archived skills, so archiving one rebuilds every Bot Chat's system prompt Open

area/sessions comp/agent P2 tool/skills type/perf

Difficulty 2/5 1-3 hours Newbie friendliness 82/100

NousResearch/hermes-agent#117788 · Opened Sep 21, 2026

More Backend & API Design issues