Skip to content

docs(agents): 完善中文文档与任务导航并采用 GitHub Issues - #1

Merged
mel0nyrame merged 4 commits into
devfrom
docs/agent-workflow
Oct 2, 2026
Merged

mel0nyrame merged 4 commits into
devfrom
docs/agent-workflow

Conversation

@mel0nyrame

@mel0nyrame mel0nyrame commented Oct 2, 2026 •

Copy link
Copy Markdown
Owner

代理维护 LinkLens 时容易把已完成规格当成当前约束,刷新、滚动和历史任务也缺少跨文件入口。本 PR 完善任务导航,明确历史资料边界,将后续任务跟踪切到 GitHub Issues,并中文化领域与分诊文档;改动仅涉及 Markdown。

任务与资料的归属变化:

 新需求 / 规格 / 实施票据
-  .scratch/<feature>/ 中的 Markdown 文件
+  GitHub Issues:正文保存需求,标签和负责人表达分诊与领取状态,评论记录验收,满足验收后关闭

 修改现有功能
+  AGENTS 按任务触发 → 任务导航中的入口和复用边界 → 对应源码与测试

 已完成的七页规格 / 票据 / 审查
-  历史约束与当前行为边界不清,旧提交范围仍声称可执行
+  保留历史正文,顶部标明失效提交引用;当前行为由 README、源码与测试核验

领域文档和分诊标签说明使用中文,保留技能名、路径、五个标签值和原有消费规则;README 的 Community 标题改为“社区”,友链正文与链接保持原样。缺少领域文档时继续任务、按相关上下文读取术语与决策、明确指出决策冲突等约定均保留。

评分报告合并摘要与补充规则,在对应章节集中说明最终取整、风险封顶、地区门槛和 Radar 计算;AI 和 DNS 章节区分上游页面设置、LinkLens 采用值与端点耗时观测。调查日期和脚本 hash 保留,本 PR 未重新调查上游,也未改变运行时算法或超时。

GitHub tracker 指向 mel0nyrame/LinkLens,保留默认分诊标签和单上下文布局,PR 需求分诊开关保持关闭。历史已完成票据继续本地归档,本次不批量创建历史 issues 或远端标签。工作树交接提供准确目录、完整分支名、票据 URL 和适用技能路径;终端验收记录脚本、输入及测量边界,统一 PTY 工具与 CI 引用检查仍属后续独立实现。

验证:

  • python3 .github/scripts/check_docs.py:15 个 Markdown 文件通过。
  • 补充检查本 PR 的 15 个 Markdown(包括历史 tracker)及 71 个本地链接:通过。
  • 中文化补充检查:仅翻译指定两个文档和 README 社区标题;标签值、技能指针、内联路径和友链 URL 保持一致。
  • 历史记录中的 10 个不同提交引用已核验为失效,并在文档中标明限制。
  • git diff --check:通过。仅改文档,未运行 Rust 或真实网络测试。

目标分支为 dev。独立展示分支 main 的 README 同步需按发布维护约定处理,本 PR 不执行其单提交历史改写。

@mel0nyrame mel0nyrame changed the title docs(agents): 完善 LinkLens 任务导航并采用 GitHub Issues docs(agents): 完善中文文档与任务导航并采用 GitHub Issues Oct 2, 2026
@mel0nyrame
mel0nyrame merged commit f203c88 into dev Oct 2, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant