Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

Chat manual pages still show retired task-state and machinery words

未关闭
#1,478 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
3/5
预计耗时
1-2 天
新手友好度
78/100
Issue 类型
文档
描述清晰度
描述清楚
活跃度
活跃
技术栈
go

调研方向

Start with the cited rows in internal/manual/chat/commands.md:1885, models-and-cost.md:673, and how-tasks-run.md:2361, then inspect the gate in internal/manual/chat_test.go:2876. Run the two deterministic codeaf manual commands and review the vocabulary carve-out and banned-word expression. Done means the prose uses current terms, exact handles are explained, the gate catches Needs your look, and invalidates records the corrected wording.

由索引模型根据 Issue 内容生成。

描述

area:chat bug sev:papercut

Seen on dev@debffabf6. Surfaced while verifying #1422; not introduced by it.

What happened

Current chat manual sections still show auditor as a role name and Needs your look as a task state, although the repo's person-facing vocabulary uses current task-state words and bans machinery terms. The corpus has a gate, TestNoChatPageSpeaksTheHarnessesOwnVocabulary, but it deliberately removes backticked handles before scanning. That explains why backticked auditor passes. Its regular expression also does not cover Needs your look.

Replication

Deterministic (no model). Run codeaf manual "what model checks task work" and codeaf manual "what happens to a task waiting on one needing my decision". Read the roles table and dependency table. Search the corpus for auditor and Needs your look; the quoted rows remain. Inspect the vocabulary gate's backtick carve-out and banned-word expression.

Where

internal/manual/chat/commands.md:1885, models-and-cost.md:673, and how-tasks-run.md:2361 at dev@debffabf6 contain the terms. The gate is internal/manual/chat_test.go:2876.

The fix

Use the current visible terms in explanatory prose and tables. Preserve a machine-readable role identifier only where a person must type or recognize that exact identifier, with an explicit explanation. Extend the gate to cover retired state phrases.

Acceptance

  • e2e: the two codeaf manual questions return current person-facing state and role language, with no unexplained retired wording.
  • Unit: the chat corpus gate catches Needs your look and any unneeded machinery term outside an exact handle.
  • Record the corrected wording in invalidates.
主要语言
Go
星标
115
派生
14
平均合并
9 小时 38 分钟
30 天内合并 PR
749

环境准备

我们还没有检查这个项目的环境配置文件。先看它的 README,通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

Agent-Field/CodeAF 的其他 Issue

查看 Agent-Field/CodeAF 的全部 Issue

相似的 Issue

更多 Go Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。