碎屑
MCP知识库服务器。将编码知识作为MCP工具，面向VS Code、Windsurf、Cursor、Claude Code和Verdent的AI助手。
安装
Codex插件：
codex plugin marketplace add benitogf/detritus插件清单位于 .codex-plugin/plugin.json；捆绑的MCP 启动器在首次使用时将最新版本的二进制文件下载到本地缓存中， 然后启动服务器。
Linux/macOS/Git Bash：
curl -sSL https://raw.githubusercontent.com/benitogf/detritus/main/install.sh | shWindows PowerShell：
irm https://raw.githubusercontent.com/benitogf/detritus/main/install.ps1 | iex或从以下网址下载 发布，放入PATH中，然后：
detritus --setupMCP工具
| 工具 | 说明 |
|---|---|
kb_list | 列出所有带有描述的文档 |
kb_get | 按名称获取文档（可选 section 参数） |
kb_search | 在所有文档中进行全文搜索 |
kb_sections | 列出文档中的章节 |
斜杠命令
| 命令 | 文档 |
|---|---|
/truthseeker | 基于证据的推理 |
/plan | 需求分析 |
/testing | 测试决策表 |
/grow | 更正后的KB改进 |
/optimize | 知识库检索优化 |
/janitor | 定期安全代码库维护 |
/coding-style | 命名、错误处理、提交 |
/go-modern | 现代围棋成语（1.22+） |
/line-of-sight | 统一代码，提前退货 |
Codex显示带有插件名称空间的插件命令，例如 /detritus:plan.
GitHub工作流家族
这 gh-* 技能是由 /gh 路由器。路由器对输入（URL、ref或自由文本）进行分类，并将其交给其中一个子技能。
| 命令 | 文档 |
|---|---|
/gh | 家庭路由器——从上下文中选择一个子技能 |
/gh-issue-create | 从对话中起草一个GitHub问题，用归因页脚发布 |
/gh-issue-work | 端到端处理问题：分支、修复、测试、提交、推送、自我审查、打开PR |
/gh-feedback-work | 处理PR的公开审查反馈；更新PR正文，从不发表评论 |
/gh-self-review | 待处理本地变更的飞行前自我审核-- 委托给新的次级代理人 因此，审查在没有产生代码的会话上下文的情况下运行 |
/gh-pr | 认真审查别人的公关；通过以下方式发布APPROVE或REQUEST_CHANGES审核 gh api |
两种模式将家庭维系在一起：
meta/review-rigor（类别：principles，不要直接调用）是两者共享的分析清单/gh-pr和/gh-self-review跟随。收紧审查栏发生在一个地方；这两种技能都是继承的truthseeker--通过其他技能加载kb_get，永远不要使用独立的斜线命令。- 新代理商代表团
/gh-self-review：包装技能收集范围+差异+意图信号，然后通过Agent工具进行实际审查。子代理没有先前的对话上下文，因此审计不会受到产生代码的讨论的影响。这并没有消除共享训练盲点，但消除了对话偏见——这是自我审查假阴性的最大来源。
门卫——定期安全维护
/janitor 安排一个重复的代码维护循环，该循环使用空闲代理配额来运行安全审计、应用小修复、验证和交付 /gh。该命令针对用户所在的实际工作区或仓库运行——默认情况下，Claude Code上的Desktop Routines或外部调度器（cron、launchd、systemd、Task scheduler），其他平台上具有等效的本地签出调度器。一个被忽视的草稿 .janitor/.md 将计划状态带过寒冬。选择GitHub状态模式（云例程、Codex worktreeGitHub Actions）用于维护远程仓库，而无需本地签出。
几个调用示例：
/janitor # whole-repo, default rubric, short interval
/janitor flaky tests # topic-focused
/janitor get test wall time under 145s # primary metric with goal
/janitor weeknights # perpetual living-maintenance; skip-streak guardrail catches drift中循环枢轴在聊天中处理——说 *“请轻推循环，使其仅关注性能”* 更新草稿行 *当前方向* 字段（在truthseeker暂停后）和下一个滴答声表示对新焦点的尊重，而无需重新调用。
看 meta/janitor 对于循环合同（审计以验证节奏、truthseeker暂停用户评论、诚实的回归报告、主要指标跟踪、可选的带跳跃条纹护栏的循环结束标准、危险队列）。特定于适配器的调度存在 meta/janitor-platforms.
更新
detritus --update或者，从安装了碎石技能的人工智能助手中，调用 /detritus-update.
发展
go generate ./... # rebuild index
go test ./...
go build -o detritus .按下标签以释放：
git tag v3.1.0
git push origin v3.1.0