SuperAPI AI 工具集

decodie-observe

编程与开发

查看项目

更新于 10-16 09:49

技能介绍

用途:Observe 模式是一个学习伙伴技能,在你编写和修改代码的同时,把遇到的编码决策、设计模式、语言特性与避坑经验记录成结构化学习条目,帮助开发者理解“为什么这样写”。

主要能力:在编码过程中实时(而非最后批量)生成条目,每条只聚焦一个概念;支持全局与项目规则(~/.decodie/rules/.md 与 .decodie/rules/.md,项目规则冲突时优先);用标题、主题标签和 decision_type 做重复检测;对被改动或删除的代码所关联的旧条目进行 supersession 标记(lifecycle 置为 superseded,可设 superseded_by)。条目含 code_snippet、explanation、alternatives_considered、key_concepts、external_docs 等,并记录 experience_level、topics、decision_type、lifecycle 等元数据,索引按时间倒序排列。

使用方式:会话开始时在项目根创建 .decodie/ 结构(含 index.json、config.json、sessions/、rules/ 目录);运行 bash scripts/summarize-index.sh "$(pwd)" 加载索引摘要(不可用时直接读 index.json);确定当日会话 ID(YYYY-MM-DD-NNN 递增);编码中交错生成并追加条目、同步更新 index.json;会话结束时写入 timestamp_end、summary。源码引用采用稳定锚点而非行号:file、anchor、anchor_hash,其中 anchor_hash 取锚点文本 SHA-256 的前 8 位,命令为 echo -n "<anchor_text>" | shasum -a 256 | cut -c1-8。

适用场景:跨语言、跨框架的项目均可使用,用于沉淀项目约定、架构选择、模式与陷阱等学习记录。

限制:默认追加式,不修改既有条目内容(除非 supersede);数据自包含,删除 .decodie/ 不影响项目;具体 VSCode 扩展、Web UI、GitHub 集成的功能与获取方式,资料暂未提供。