SAP-samples / SAP-samples/codejam-code-based-agents
JavaScript track: exercises 06 and 07 appear to be in the wrong order
まだ誰も着手していません。
- 主要言語
- Python
- スター
- 54
- フォーク
- 36
- PR マージ指標
- 30日以内にマージされた PR はありません
説明
Summary
06-discover-connected-crimes.md references code that's only introduced in 07-solve-the-crime.md:
- Around line 238, it calls
this.orchestrationClient.chatCompletion(...), butorchestrationClientas a class field is only declared and constructed in exercise 07's Step 1 (07-solve-the-crime.md, "AddorchestrationClientas a class field and initialize it in the constructor"). - Around line 213, it instructs learners to add the new node "before
leadDetectiveNode" — butleadDetectiveNodeis also only created in exercise 07.
Effect
Following the exercises in their numbered order (06 then 07), a learner's investigationWorkflow.ts wouldn't type-check at exercise 06's step — this.orchestrationClient doesn't exist as a class member yet, and leadDetectiveNode doesn't exist to insert before.
Suggested fix
Either:
- Swap the exercise order (make current 07's class-field/constructor setup + Lead Detective node come before current 06's Intelligence Researcher node), or
- Move the
orchestrationClientclass-field/constructor setup into exercise 06 itself, and have exercise 07 only addleadDetectiveNode.
Either way, the sequencing needs to match what the code in each step actually depends on.
Environment
Reproduced on a personal SAP AI Core tenant, JavaScript/TypeScript track, exercises 01–07 followed in numbered order.
コントリビューションガイド
このリポジトリのコントリビューションガイドは索引されていません
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
調査の方向性
06-discover-connected-crimes.md と 07-solve-the-crime.md から始め、参照されている investigationWorkflow.ts のステップとその番号順を比較します。exercise 06 で使用する前に orchestrationClient と leadDetectiveNode が導入されていることを確認し、その後 exercise 01–07 を追って、各ステップで JavaScript/TypeScript のワークフローが型チェックを通過することを確認します。
索引モデルが issue の本文から書いたものです。
評価
- 技術スタック
- javascript, typescript
- 領域
- documentation
- issue の種類
- ドキュメント
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 活発さ
- 活発
- 明瞭さ
- 明確に書かれている
- 初心者へのやさしさ
- 78/100