Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Retire the /tools and /agents site pages

オープン
#630 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

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

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
55/100
issue の種類
リファクタリング
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
next.js, typescript

調査の方向性

Start by checking imports of the listed pages, data files, and card components, then inspect the navigation links in src/components/navbar.tsx, src/components/footer.tsx, and src/components/key-components.tsx. Update redirects in next.config.mjs and sitemap generation in scripts/sitemap.js, then regenerate public/sitemap.xml. Done when the old routes redirect to live docs, navigation and sitemap contain no removed URLs, the build and link checker pass, and #521 reflects the removed agent page.

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

説明

help wanted

The site's /tools and /agents pages no longer describe the product, and they were last refreshed in May 2025. This issue replaces #63 and #86, which asked for another refresh.

The problem

  • /tools comes from src/data/tools.json. It lists 137 tools under the Python kagent.tools.* provider IDs, a format kagent no longer uses. The current tool server is documented in docs-site/content/kagent/0.x/resources/tools-ecosystem.md and docs-site/content/kagent/1.x/reference/tools-ecosystem.md.
  • /agents comes from src/data/agents.json. It lists 8 agents. kagent v0.10.1 ships 10 agent charts (helm/agents/), and 1.x ships no bundled agents.
  • No script generates either file, so any refresh starts drifting again immediately.

Scope

Remove the pages instead of refreshing them.

  • Delete src/app/tools/, src/app/agents/, src/data/tools.*, src/data/agents.*, src/components/agent-card.tsx, and src/components/category-card.tsx, after checking that nothing else imports them.
  • Repoint the remaining links at /docs/kagent/0.x/resources/tools-ecosystem. They are in src/components/navbar.tsx (Tools and Agents entries), src/components/footer.tsx, and src/components/key-components.tsx (home page cards). Drop the Agents entry instead of repointing it, unless a fitting 0.x page exists.
  • In next.config.mjs, add permanent redirects for /tools, /tools/:categoryId, /agents, and /agents/:agentId, placed above the catch-all redirect.
  • Remove the agent and tool routes from scripts/sitemap.js. Remove the getDynamicRoutes() blocks that read agents.json and tools.json, the tools/ and agents/ entries in DYNAMIC_PATTERNS_TO_EXCLUDE, and the top-level require of src/lib/getToolCategoryId. When the JSON files are missing, the script only logs warnings. If getToolCategoryId.js is deleted while the require remains, every build fails. Then regenerate public/sitemap.xml.

Interaction with #521

Link to 0.x only, not 1.x. Pointing site navigation at 1.x before GA is what #521 holds. #521 lists src/app/agents/[agentId]/page.tsx:110 as a link to fix at GA. Once this issue lands, that page no longer exists, so tick or remove that item in #521. The GA cutover then moves the new redirect targets to 1.x.

Done when

  • /tools and /agents and their subpaths redirect to a live docs page.
  • The navbar, footer, and home page contain no links to the removed pages.
  • The sitemap no longer lists the removed URLs.
  • npm run build passes, and the link checker reports no new broken links.
  • #521 reflects the removed agent page.
主要言語
TypeScript
スター
21
フォーク
69
平均マージ
14時間 16分
マージ済み PR(30日)
105

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

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

kagent-dev/website のほかの issue

kagent-dev/website の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。