本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：
- 我的帖子已经打上 开源推广 标签： 是
- 我的开源项目完整开源，无未开源部分： 是
- 我的开源项目已链接认可 LINUX DO 社区： 是
- 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是
- 以上选择我承诺是永久有效的，接受社区和佬友监督： 是
以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出
补充
建议佬们先让你们的 Agent 充分理解，结合自己的情况决定蒸馏到自己的方法论或 skill，还是直接安装使用
欢迎大家一起讨论关于人与 Agent 协作的探索和经验，这个 skill 最重要的目的是分享自己的方法论
我是一个重度的 Coding Agent 用户，我的 Agent 基本上 24 小时不间断地在跑。学习调研、工作项目、开源项目、折腾安卓自动化、折腾电视、分析投资、管理生活事项等等，都在尝试让 Agent 参与。最近也一直在 Codex、Claude Code、DeepSeek Harness 之间折腾，希望找到更舒服、更高效的使用姿势
之前为了随时随地使用 Agent，还做了一个安卓 SSH / mosh 客户端 moke，在站里分享过：
用得越多，另一个问题就越来越明显：项目和工作目录很多，会话也很多，我自己的想法、需求、个人偏好，上次工作推进到哪里、为什么选了这个方案、调研中间发现了什么，经常散在不同的对话里。换个会话或者换个 Agent，又得重新解释一遍；有些当时很有价值的东西，过段时间就找不到了
目前接触到的记忆方案还没有让我特别放心，记什么、怎么更新、什么时候能用上，都还有不少问题，这里先不展开。各家 Harness 自带的记忆也有各自的存储和加载方式，换一个工具，之前积累的东西未必能直接接着用
OpenViking 是一个不错的方向，把知识、记忆和技能统一组织成虚拟文件系统，通过目录、分层摘要和检索来按需获取上下文，也能从会话里提取长期记忆，适合需要持续积累、跨会话复用上下文的场景。Github：volcengine/OpenViking
我没有实际用，对我目前的需求来说，额外的服务、模型配置和 Agent 接入维护稍微有些重。我更希望直接在项目目录里看到和修改全部内容，用普通文件和 Git 就能管理。我自己更顺手的方案，就是这次分享的 knowledge-project
最初的萌芽是一月份折腾 OpenClaw，后来到 Hermes，再到越来越多项目开发时维护的 docs 目录。我一直在积攒和迭代：项目知识怎么组织，代码和数据怎么放，工作进度怎么接续，经验和个人偏好怎么沉淀。折腾了大半年，如今我个人的项目都在用这套方法来管理，也就把它整理成了一个 skill
skill 只提供方法论，所有项目上下文都保存在项目文件里
项目的目标、约定和协作偏好写在 AGENTS.md，工作进展、关键决策和下一步记到 log.md；调研结果、方案和踩坑经验按内容组织，需要的时候再读。代码和数据保留各自的格式，知识文档用 Markdown，参考了 OKF 的文件组织和 YAML 元数据约定
也约定了怎么从试错过程里留下有用的东西，什么时候该调整项目结构，规则越来越多时怎么精简，希望每次工作结束后，除了完成眼前的任务，还能留下有用的积累
对我来说最实用的地方是，换 Agent、换会话之后，可以让它从项目文件里恢复目标、约定和进度，接着往下干。项目建立起来以后，即使没有安装这个 skill，也能按项目里留下的规则继续维护。我自己随时能看、能改，也不用额外维护一个记忆服务
下面是 description，能比较好的描述清楚应用场景和效果：
让知识工作项目对 Agent 自描述、跨 session 可接续，并治理项目里的规则与工作纪律。
两类场景使用：（一）项目组织——新建或初始化项目、整理或健康检查项目结构、设计目录与导航、写 frontmatter/index/log/决策记录、把探索期的临时文件沉淀下来、恢复一个还没有规则文件的项目的上下文；（二）工作方法论——同类问题反复出现要固化成规则、规则太多或互相冲突要精简、新增或删除一条项目规则、给项目立检查脚本或门禁并判断它是否有效、沉淀经验教训、回顾或改进方法论本身。
触发词：新建项目、初始化文档结构、帮我整理这个项目、项目怎么组织、健康检查、又踩坑了、固化成规则、规则太多、精简规则、门禁、检查脚本、沉淀、蒸馏、经验教训、决策记录、回顾方法论、setup project、project health check。
新开一个学习调研项目，可以直接说“用 knowledge-project 初始化一下这个项目”；一个项目折腾了很多轮，文档、脚本、临时数据越堆越多，就说“帮我整理这个项目，把有用的结果和经验沉淀下来”；同一个坑反复踩，或者 AGENTS.md 越写越长，就让它检查和整理规则。这样下次再来，可以直接找到之前的结论、方案取舍和下一步要做的事，不用重新翻一遍聊天记录
项目地址：
安装：
npx skills add briqt/knowledge-project -g -y
装好后，直接让 Agent 用 knowledge-project 整理一下当前项目，或者初始化一个新的知识项目就可以。大家如果也经常在多个项目、多个 Agent 之间切换，可以试试看，有问题或者更好的想法欢迎交流，我持续使用、持续迭代
