huytieu/COG-second-brain

项目介绍

COG 是一套技能和代理框架，把一个 Markdown 笔记文件夹变成由 AI 持续维护的个人知识系统，配合 Obsidian 和 Claude Code、Cursor、Kiro、Gemini CLI、Codex 等编程代理使用。它不依赖数据库，也没有托管服务：技能直接读写仓库内固定目录中的 .md 文件，包括收件箱、日记、个人与职业灵感、项目、以及整理后的知识库。

仓库提供 43 个技能和 10 个代理。技能覆盖记录与回顾（braindump、daily brief、weekly check-in、knowledge consolidation）、产品经理工作流、研究、内容生产、写作与设计评审，以及一个按提及次数把人物档案从骨架升级为完整档案的 people CRM。worker 代理承担数据密集的步骤，主会话负责推理；另有一组只读 verifier 依据验收标准观察产物，而不是给 worker 自己的总结打分。

快速使用

准备：Git、用于可选 npx 安装方式的 Node.js，以及一个受支持的代理。先克隆仓库并把它作为工作目录打开：

git clone https://github.com/huytieu/COG-second-brain.git
cd COG-second-brain

然后在该目录启动代理并让它执行 onboarding：Claude Code 中 code . 后说 "Run onboarding"；Cursor 或 Antigravity 打开文件夹后说 "Run onboarding"；Gemini CLI 执行 gemini 后用 /onboarding；Codex 执行 codex 后说 "Run onboarding"。没有专属入口的代理可以指向 AGENTS.md。也可以通过 skills.sh 安装：

npx skills add huytieu/COG-second-brain

onboarding 会个性化笔记库并选择角色包，通常几分钟内完成。Git 同步、iCloud、Obsidian Tasks 等可选配置见 SETUP.md。配置完成后，日常使用从一次 braindump 或索取简报开始，结果会写入对应的笔记目录。

验证闭环

可选启用的闭环是该项目的核心特点。请求后，工作按 V 模型执行：左侧分解出可证伪的验收标准，构建位于顶点，右侧验证并把证据逐条追溯到标准。四个 verifier 代理只读，接收的是产物路径而不是 worker 输出。相关技能包括 closed-loop、用于跨会话大目标的 ultragoal、提出技能补丁的 harvest、审查证据质量的 retro，以及管理多事项会话的 review-cockpit。不主动请求时，这些检查点和证据台账都不会运行。完整流程见 WORKFLOW.md。

使用约束

• 所有内容都是本地 Markdown；README 说明数据不存于外部服务器，只有调用技能时才会访问代理的 API。隐私程度取决于所用代理以及你启用的集成。
• 团队与 PM 技能在配好 GitHub CLI（gh）以及 Linear、Slack、PostHog 的 MCP 集成时效果最好；文档称缺少集成时会平滑降级，只接 GitHub 也可以起步。
• 各代理支持程度不同：Claude Code 和 Antigravity 是完整界面，Kiro 与 Gemini CLI 目前各提供 7 个原生入口，AGENTS.md 是通用后备方案。
• 闭环会带来额外的检查与证据工作；可以按请求启用，也可以在个人配置中为构建类任务默认开启。
• 更新会区分框架文件与个人内容，检测到自定义时逐文件询问。Git 推荐但不强制，可以只用 iCloud 同步。
• 采用 MIT 许可证；费用只有所用 AI 代理的 API 消耗。

HotRepo 点评

2026-11-15 该项目在 Python 日榜排第 7，单日新增 37 星，说明这套本质上是技能与代理配置集合、而非传统库的仓库出现了一波关注。这与它的设计相符：真正有意思的工程在流程约定上——只读 verifier、产物路径交接、证据台账、反 slop 检查——这些不装运行时也能直接阅读和改写。需要留意的是各代理界面支持不均，团队类功能依赖外部集成，这两点文档本身也写得很清楚。