Agent Skills
返回列表
开发者项目 Wiki

开发者项目 Wiki

知识管理 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_ef796dd2/coder-llm-wiki。

技能介绍

问题在哪

代码仓库里真正有用的知识往往散落在 PR 描述、口头约定和过期的 README 里。重构或修 bug 之后，下一位维护者很难快速回答：改了什么、为什么改、模块边界在哪、外部资料对应哪段代码。通用知识库写法还容易和 code_root 脱节，页面类型混乱，链接断了也没人补。

技能怎么工作

coder-llm-wiki 的定位是只维护面向开发的 wiki，默认落在 docs/wiki，通过读代码理解事实，但不修改 ./src 下的业务代码。首次使用会先让你选配置：用技能默认根目录，还是从项目的 AGENTS.md / CLAUDE.md 解析 wiki_root、code_root、raw_root。

页面类型是约定好的契约，而不是随意起名：

  • changes/*.md：变更背景、影响、测试与跟进
  • modules/*.md：职责、入口、接口、依赖、测试与债务
  • sources/*.md：外部资料映射到模块与行动项
  • concepts/*.md、decisions/*.md：项目概念与已确认的 ADR
  • index.md、log.md：入口与时间线

核心流程对应不同意图（如 change、module、ingest）：先收集证据（用户说明、变更文件、可选的 git diff/git log），再写页并同步维护关联链接——变更页要链到模块页，并更新 index.md 与 log.md。辅助能力包括 query（回答前对照新代码做新鲜度检查）、lint（缺页、断链、漂移）、sync（扫描建议，默认不批量改）。

边界与注意点

  • 硬边界：不删历史变更记录；不用破坏性 git/shell；不把 diff 或目录名猜测写成事实；模块边界不清要问清楚。
  • 确认规则：涉及超过 3 个代码文件或 3 个 wiki 页的大范围更新会先汇总再写；动机缺失时标为假设，不凭弱证据自动建 ADR。
  • 不适用：只想改产品代码，或写与开发无关的对外文档时，不要用本技能。

使用场景

  • 完成跨多个模块的重构后，需要把变更原因、影响路径和测试缺口写入 `changes/` 并回链相关 `modules/` 页。
  • 新同事接手某目录职责不清，需要对照 `code_root` 梳理入口、接口与依赖，补齐或刷新 `modules/*.md`。
  • 读完外部技术文章或 RFC，需要建 `sources/` 页并标明对应模块、概念页更新项与未确认的跟进事项。
  • 回答「这个接口为什么这样设计」前，先用 wiki 检索并对照近期变更页，判断现有模块说明是否已落后于代码。

适合人员

  • 负责长期维护单体或微服务仓库的后端工程师，希望变更记录与模块契约跟代码同仓、可检索。
  • 在开源或内部平台组做技术写作的维护者，需要按规范页型维护 `index.md`/`log.md` 而不是堆零散笔记。
  • 牵头架构治理的 Tech Lead，要把已拍板的技术取舍写成 `decisions/` ADR 并链到相关变更与模块页。
  • 频繁做 Code Review 的资深开发，想用 `lint`/`sync` 发现断链、缺页或与 `git diff` 不一致的 wiki 漂移。