SuperAPI AI 工具集

ai-brag-document

智能体与模型

查看项目

更新于 10-15 20:29

技能介绍

用途:把工程工作记录整理成简洁、有证据支撑的影响力文档,服务于绩效评估、晋升讨论、校准与职业反思。文档需快速回答五个问题:改了什么、为何重要、作者本人负责什么、有哪些证据、结果是已确认、预期、目标还是进行中。

主要能力:按固定流程工作——确定范围与报告期、发现相关工作与证据、建立内部证据台账、把相关工作归并为影响力叙事、撰写执行摘要与主体章节、区分进行中与未验证结果、添加技术证据附录、执行质量检查。

使用方式:以 Obsidian 库为唯一事实来源,固定路径为 VAULT_PATH="$HOME/Documents/obsidian/obsidian",输出到 $HOME/Documents/obsidian/obsidian/brag-document.md,并确保 engineering/index.md 链接该文档。发现阶段对 engineering 目录做六轮扫描:清点全部 Markdown 笔记、查找 workplan 与设计文档、查找 PR 证据、查找交付/事故/上线/生产证据、查找作者与归属证据、读取并遍历每个候选笔记。写入时先渲染到临时文件再原子替换,并读回验证;随后更新索引,仅暂存 brag-document.md 与 engineering/index.md,提交信息为 docs(engineering): update brag document,不推送。

适用场景:需要基于库内笔记生成或更新工程影响力文档,且库为 Git 仓库、暂存区为空时。

限制:库或 engineering 目录不存在、库非 Git 仓库、暂存区已有变更时停止;内容必须来自库内笔记,外部来源仅可验证已有引用;不得把未实现的 PRD、空 workplan、无实现的草稿设计、状态不明的开放 PR 或未测量的目标指标当作已完成成果;不推送远端。其他细节暂未提供。