Skip to content

Latest commit

 

History

History
77 lines (69 loc) · 10 KB

File metadata and controls

77 lines (69 loc) · 10 KB

GitHub 调研、采用决策与致谢

初次审计日期:2026-08-04;v6.2 交互模式补充调研:2026-08-09。仓库存在性、archived、pushed_at 和 GitHub 检测到的 SPDX 许可证通过 GitHub 官方仓库/API 复核。活跃度只描述审计日 观察:高=近 30 天有 push;中=近 180 天有 push;低=超过 180 天无 push。 许可证为 未检测到 时不推定可复制。本 Skill 只独立实现公开思想,没有复制 下列项目的源代码、提示词或协议文本。

调研表

项目 核心思想与实现方式 许可证 活跃度 对本 Skill 的结论
Engramory typed Markdown memory、bounded index、单事实文件、doctor MIT 高;未归档 可直接借鉴机制思想:采用 bounded 本地索引、typed candidate 和 doctor;致谢。
Mem0 多层 memory、add/update/delete/history 生命周期,常配向量检索 Apache-2.0 高;未归档 只借鉴生命周期;不引入云服务、向量库或自动保存聊天。
Letta / MemGPT core/working/archival memory 与持久 agent state Apache-2.0 高;未归档 只借鉴 working/durable 分层;完整 server/runtime 不适合零依赖 Skill。
Zep Graphiti episode provenance、时序有效性、失效边、图检索 Apache-2.0 高;未归档 只借鉴 provenance/stale 思想;图数据库与自动抽取不采用。
LangGraph checkpoint、interrupt、durable resume、显式 graph state MIT 高;未归档 可直接借鉴机制思想:显式状态、handoff、hash drift→repair;不引入框架依赖。
OpenHands 事件流、session create/resume、运行版本和执行结果分离 MIT 高;未归档 只借鉴事件/恢复思想;sandbox/runtime 不嵌入 Skill。
SWE-agent 可复现 trajectory、环境执行与评分分离 MIT 高;未归档 只借鉴 evaluation separation;不采用其 agent runtime。
Aider revision-aware repo map、git diff/commit 驱动的源码上下文 Apache-2.0 中;未归档 只借鉴 revision/source lock;不复制 repo-map 算法。
AutoGen agent/message/runtime state 与多 Agent 编排 CC-BY-4.0 中;未归档 不适合作为依赖:多 Agent runtime 扩大状态面,和本地单主线 fail-closed 冲突。
CrewAI flow/crew state、任务编排、持久 execution MIT 高;未归档 不适合作为依赖:角色编排不能替代唯一权威状态与 receipt。
learn-codebase 苏格拉底提问、prediction、active recall、学习日志 MIT 中;未归档 可直接借鉴教学思想:采用回忆、评价、retest;致谢。
PocketFlow Tutorial Codebase Knowledge 从核心抽象、关系与调用流生成初学者教程 MIT 中;未归档 可直接借鉴文档思想:教材按调用依赖组织;生成器/runtime 不引入。
RepoAgent AST/调用关系、仓库级文档、增量更新 Apache-2.0 低;未归档 只借鉴 source-grounded/incremental 思想;AST 全量生成超出通用 Skill 边界。
CodeTour 文件/行号锚点组成可重放源码路线 MIT 中;未归档 可直接借鉴机制思想:路径+精确行段+snippet 校验;不复制 tour schema。
Diátaxis 将 tutorial、how-to、reference、explanation 按用户需求分离;先给最小解释,再按需进入深入材料 README 标注 CC-BY-SA 4.0;GitHub API 为 NOASSERTION 高;未归档 可直接借鉴信息架构思想:Step 本地闭环、检索索引和共享 deep dive 分层;不复制其文档文本。
Material for MkDocs Markdown 文档的搜索、目录、breadcrumbs、源码归属和多设备导航 MIT 高;未归档;2026 年进入 maintenance mode 只借鉴导航思想:在单 Markdown 中加入关键词/源码/Q-ID 索引;不引入站点 runtime。
mdBook Markdown 章节树、搜索和前后导航 MPL-2.0 高;未归档 只借鉴导航思想:Step 锚点和 previous/next;不复制实现。
Rust by Example 用小而完整、可应用的例子学习技术概念 Apache-2.0 OR MIT 高;未归档 可直接借鉴教学粒度:每 Step 一个项目最小例子;不复制其示例。
Log4brains 轻量 docs-as-code、可搜索元数据、时间线和 <details> 渐进披露 Apache-2.0 低;未归档;最后 push 2024-12-17 只借鉴轻量知识组织:内容预算、去重和可选深读;不引入 ADR 工具链。
Docusaurus sidebar、版本化、文档站检索和多页面路由 MIT 高;未归档 当前不适合引入:多文件站点和 Node runtime 会扩大 hash/receipt/部署边界;仅参考导航概念。
DeepWiki-Open 仓库知识库、结构导航、关系图 MIT 高;未归档 只借鉴可导航知识结构;云检索和自动 wiki 不能证明教学深度。
MathTutorBench 教学能力任务、teacher-grounded scoring、错误定位与 scaffolding 未检测到 高;未归档 只借鉴 rubric/evaluation 思想;无明确许可证,不复制代码或数据。
EducationQ 教育型对话质量维度与评估 论文,以出版条款为准 论文 只借鉴评估维度;不导入数据或量表原文。
GitHub Copilot customization 区分 repository instructions、prompt files、skills 与 hooks 的作用域 官方文档条款 活跃官方文档 可直接借鉴职责分层思想:用户自然输入、Skill 工作流、协议资源、宿主强制分开;不复制提示词。
Claude Code skills Skill 可自动/手动触发、正文加载后保持有效;压缩仍需显式恢复机制 官方文档条款 活跃官方文档 只借鉴调用与上下文边界:Skill 管机制,handoff 管恢复;不假设宿主 hook 已执行。
Anthropic skills / skill-creator 元数据、主体、按需 references/scripts 的渐进披露 Apache-2.0 高;未归档 可直接借鉴信息分层思想:短响应合同 + scoped protocol;未复制模板或协议。
Superpowers phase trigger、hard gate、计划与验证闭环 MIT 高;未归档 只借鉴硬门禁思想:intake-before-answer、repair-only、verification-before-claim;不引入运行时。
awesome-copilot 可组合 instructions/prompts/agents 与简洁行动 handoff MIT 高;未归档 只借鉴简洁交接思想:一个自然入口、一个唯一下一行动;不复制提示内容。

实际采用

  1. Engramory 的 bounded/typed 本地记忆,重做为 candidate/approved/saved/rejected/stale,拒绝内容脱敏。
  2. LangGraph/OpenHands 的 checkpoint、event、resume 思想,重做为不可重放 input event、完整 handoff 和 REPAIR_REQUIRED。
  3. SWE-agent 的执行与评估分离,重做为 static validator、real-host、 real-compaction 和 multi-model 四类独立结果。
  4. CodeTour/Aider/RepoAgent 的 revision/path/call relation 思想,重做为锁定 revision、精确行段和源码片段一致性校验。
  5. learn-codebase、PocketFlow 教程和 MathTutorBench 的教学思想,重做为 NODE 短合同、分类型 QA 深度合同、逐 Step 学习闭环和冷启动练习。
  6. CodeTour、Diátaxis、Material for MkDocs、mdBook、Rust by Example 和 Log4brains 的导航/渐进披露思想,重做为 schema 2.1 快速索引、8 槽位 Step 条目、阅读/源码预算、跨 Step 去重、共享 deep dive,以及 “定位→解释→应用”的冷启动测试。
  7. learn-codebase 的自然追问、GitHub Copilot/Claude Code/Anthropic skills 的 职责与渐进加载边界、Superpowers 的阶段硬门禁、awesome-copilot 的简洁 handoff,重做为 v6.2 的单启动提示、七模式响应、两阶段任意问题事务和 定位→学习→检验→沉淀→等待 标准循环。

明确拒绝

  • 不引入默认向量数据库、图数据库、云 memory 或外部账号。
  • 不保存完整聊天,不把一次性问题自动写入长期 memory。
  • 不让多 Agent runtime 成为权威状态机。
  • 不把自动生成的 wiki、摘要、repository map 当作源码证据或学习完成证明。
  • 不引入 Docusaurus/MkDocs/mdBook 站点运行时;正式产物仍是一个可离线、 可 hash、可由统一 receipt 绑定的 Markdown。
  • 不采用会削弱证据等级、用户 consent、fail-closed、research 副本隔离或 隐私边界的外部方案。
  • 不把官方文档描述的“可调用”误写为当前宿主已执行 hook;宿主控制仍需 独立 receipt 证明。

感谢上述维护者、研究者和贡献者公开这些项目与思想。本仓库与它们无隶属、 赞助或背书关系;第三方权利和许可证归各自权利人所有。