Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

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

Aperta Adatta ai principianti
  • Qualcosa non va?
#91 5 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
Meno di un'ora
Idoneità per principianti
75/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
html, python
Ambito
frontend

Direzione di ricerca

Leggi web/blueprints/tasks.py, in particolare _auto_link_files, _render_md_inline e _render_md_block, per vedere come vengono aggiunti attualmente i link per i criteri Human. Estendi il comportamento esistente alle sezioni di attività specificate, quindi verifica che i percorsi esistenti ai documenti del progetto diventino link solo quando i file esistono. L’issue non indica alcun file di test, quindi individua il test pertinente per il rendering della pagina delle attività oppure controlla una pagina delle attività servita.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.

Lingua principale
Shell
Stelle
16
Fork
6
Merge medio
6h 24m
PR unite (30g)
5

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di DimitriGeelen/agentic-engineering-framework

Tutte le issue di DimitriGeelen/agentic-engineering-framework

Issue simili

Altre issue su Shell/Bash

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.