Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

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

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#91 5 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
Dưới một giờ
Mức phù hợp với người mới
75/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
html, python
Lĩnh vực
frontend

Hướng nghiên cứu

Đọc web/blueprints/tasks.py, đặc biệt là _auto_link_files, _render_md_inline và _render_md_block, để xem các liên kết hiện được thêm cho tiêu chí Human như thế nào. Mở rộng hành vi hiện có sang các phần tác vụ được chỉ định, sau đó xác minh rằng các đường dẫn tài liệu dự án hiện có chỉ trở thành liên kết khi các tệp tồn tại; issue không nêu tệp kiểm thử, vì vậy hãy xác định bài kiểm thử kết xuất trang tác vụ phù hợp hoặc kiểm tra một trang tác vụ được phục vụ.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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.

Ngôn ngữ chính
Shell
Star
16
Fork
6
Merge trung bình
6 giờ 24 phút
Pull request đã merge (30 ngày)
5

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của DimitriGeelen/agentic-engineering-framework

Tất cả issue của DimitriGeelen/agentic-engineering-framework

Issue tương tự

Thêm issue về Shell/Bash

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.