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

[Feature]: On a task page, link document paths written in Context and Agent criteria, not only in Human criterion steps

オープン 初心者向け
  • 何か問題がありますか？
#91 コメント 5 件 リアクション 0 件 担当者 0 名 GitHub で見る

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

評価

難易度
2/5
見積もり時間
1時間未満
初心者へのやさしさ
75/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
html, python
領域
frontend

調査の方向性

web/blueprints/tasks.py、特に _auto_link_files、_render_md_inline、_render_md_block を読み、Human criteria に対するリンクが現在どのように追加されているかを確認してください。既存の動作を指定されたタスクセクションに拡張し、既存のプロジェクトドキュメントのパスが、ファイルが存在する場合にのみリンクになることを検証してください。issue にはテストファイルが指定されていないため、関連するタスクページのレンダリングテストを特定するか、配信されたタスクページを確認してください。

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

説明

area:watchtower enhancement severity:low status:released triaged
Problem

On /tasks/T-XXX, a path to a project document becomes a link in two cases only:

  • the file is named docs/reports/T-XXX-*.md (listed automatically as a research artifact);
  • the path is written in the **Steps:**, **Expected:** or **If not:** of a ### Human criterion.

The same path written in ## Context, in an ### Agent criterion or in the task description is shown as plain text. In web/blueprints/tasks.py, _auto_link_files is called from _render_md_inline and _render_md_block (lines 385 and 401), which are applied to the parsed Human criteria; the rest of the task body is shown as raw Markdown source.

Consequence observed in one project: of 24 documents, 10 were reachable from a task page and 14 were not, although 8 of those 14 were cited in a task file. To attach them, the agent added nine ### Human criteria of the form "open this note and confirm it". Some of these criteria exist mainly to carry a link, which adds review boxes for the operator and dilutes the meaning of a Human criterion.

Proposed Solution

Apply the same existence-gated path linking to ## Context and to ### Agent criteria.

Or add an explicit field, for example a documents: list in the task frontmatter, rendered as a "Documents" block on the task page next to the automatic research artifacts.

Subsystem

Watchtower (Web UI)

Scope

Small (single file, <1 hour)

Alternatives Considered
  • Naming every document docs/reports/T-XXX-*.md: works for research notes, not for deliverables that keep their own name and directory.
  • Writing a Human criterion for each document: this is the workaround in use; it works but multiplies review boxes.
Additional Context

Version: 1.8.6 (1ea10441f), vendored consumer. First seen on 1.8.3; web/blueprints/tasks.py is byte-identical between the versions. Checked again on a served task page of 1.8.6: a path written in ## Context has no href.

主要言語
Shell
スター
16
フォーク
6
平均マージ
6時間 24分
マージ済み PR（30日）
5

環境構築

はじめの一歩

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

DimitriGeelen/agentic-engineering-framework のほかの issue

DimitriGeelen/agentic-engineering-framework の issue をすべて見る

似ている issue

Shell/Bash の issue をもっと見る

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

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