Agent Skills
› I7T5/Edmund
I7T5/Edmund
GitHubEdmund Markdown编辑器架构契约，规定TextKit 2渲染、存储同步及编辑流核心规则。用于指导重大代码变更、新机制设计及解决光标漂移等历史难题，确保display与rawSource一致。
Install All Skills
npx skills add I7T5/Edmund --all -g -y
Skills in Collection (31)
Edmund Markdown编辑器架构契约，规定TextKit 2渲染、存储同步及编辑流核心规则。用于指导重大代码变更、新机制设计及解决光标漂移等历史难题，确保display与rawSource一致。
进行非平凡代码变更前
询问架构设计原因时
提出新机制或重构方案时
涉及NSTextView底层操作或视图同步时
npx skills add I7T5/Edmund --skill edmund-architecture-contract -g -y
Edmund macOS编辑器构建与环境配置指南。涵盖从零搭建环境、核心构建命令、build-app.sh脚本原理、解决构建陈旧问题、处理SwiftMath/Sparkle依赖陷阱及调试包制作，确保构建与运行稳定。
从零开始设置开发环境或新机器配置
构建失败或构建结果未生效（陈旧构建）
应用启动崩溃或LaTeX渲染异常
需要构建用于实时运行的调试包EdmundDbg.app
验证刚构建的二进制文件是否可信
npx skills add I7T5/Edmund --skill edmund-build-and-env -g -y
针对Edmund项目中NSTextView的删除漂移（caret/selection错位）问题的专项调试流程。通过日志签名分类、验证既有防御机制、复现断点、构建确定性脚本并严格验证修复，确保文本编辑状态一致性，排除视口滚动问题。
光标或选区在删除/输入/拖拽后位置错误
文本编辑导致内容不同步或损坏
自动保存写入陈旧内容
日志出现⚠︎LEN-MISMATCH或绕过didChangeText的提示
npx skills add I7T5/Edmund --skill edmund-caret-integrity-campaign -g -y
定义Edmund仓库的代码变更分类与审核流程。明确文档、逻辑、视觉及编辑管道等变更类型的验证门禁，强制要求分支操作、测试运行、截图及现场复现，确保变更质量并防止历史问题复发。
修改仓库代码或文档前
决定是否需要测试或视觉检查时
不确定是否需联系维护者时
执行发布或分支操作前
npx skills add I7T5/Edmund --skill edmund-change-control -g -y
Edmund Markdown编辑器配置与标志目录，涵盖UserDefaults键、启动参数、编译时开关及日志配置。用于添加设置、排查行为控制标志、调试启动审计默认值或集成新偏好。
添加或修改应用设置
查找控制特定行为的标志
使用调试标志启动应用
审计默认配置值
将新偏好集成到实时编辑器
npx skills add I7T5/Edmund --skill edmund-config-and-flags -g -y
Edmund应用故障排查手册，提供新Bug的15分钟快速分诊清单、日志分析与构建检查步骤。旨在通过标准化流程避免重复已知问题，识别深层机制陷阱，确保高效定位渲染、光标漂移及崩溃等异常。
收到Edmund应用Bug报告或意外行为反馈
需要对新出现的UI渲染错误、光标位置偏差或应用崩溃进行初步分诊和原因排查
npx skills add I7T5/Edmund --skill edmund-debugging-playbook -g -y
负责Edmund项目的文档规范与写作指南，明确各事实的唯一归属文档及路由规则。涵盖架构、变更日志、路线图等文档的编写标准、调查模板及维护职责，适用于文档创建、更新及知识归档决策。
撰写或更新项目文档（如ARCHITECTURE.md, CHANGELOG.md等）
决定新发现的事实、Bug或特性应归属哪个文档
npx skills add I7T5/Edmund --skill edmund-docs-and-writing -g -y
作为外部定位防火墙，规范Edmund对外宣传内容。确保所有公开声明（如README、博客、营销文案）均可从仓库复现，严禁夸大未验证功能或标签“新颖”。用于对比竞品、规划生态发布及审核公共主张的严谨性。
撰写面向外部的文档或营销文案
将Edmund与其他编辑器进行对比
决定公开声明与未证实内容的界限
标记技术为‘新颖’或规划生态工作
npx skills add I7T5/Edmund --skill edmund-external-positioning -g -y
记录Edmund编辑器重大Bug调查、死胡同及被撤销修复的历史档案。用于在复现光标漂移、视图滚动故障或渲染问题时，避免重复尝试已知无效方案，提供根因与证据参考。
重现已知的 caret/selection 症状（如漂移、不同步）
遇到视图/滚动故障（如跳动、震荡）
发现渲染问题（如裁剪、空白）
发布失败或签名错误
提出可能已被尝试并撤销的修复方案
Bug报告看起来似曾相识
npx skills add I7T5/Edmund --skill edmund-failure-archaeology -g -y
用于复现和诊断 Edmund 中无法通过无头测试重现的实时行为缺陷（如 IME、拖拽、视口时序）。提供从单元测试到进程内脚本及 CGEvent 驱动的升级复现阶梯，包含安全操作规范、诊断日志解读及自动化测量工具。
遇到涉及实时行为（光标、IME、拖拽、视口时序）的 Bug
单元测试无法复现用户报告的故障
需要读取诊断追踪或驱动运行中的应用进行按键模拟
需要从截图中测量像素以验证 UI 状态
npx skills add I7T5/Edmund --skill edmund-live-repro-and-diagnostics -g -y
Edmund应用发布与运维技能，涵盖版本升级、CI构建、签名及DMG制作。用于处理Sparkle更新失败、Gatekeeper拦截、崩溃日志分析及发布流程验证，仅限维护者明确指令时执行。
版本号变更或打标签
Sparkle更新失败或签名错误
Gatekeeper报告文件损坏
查看崩溃日志或应用启动问题
npx skills add I7T5/Edmund --skill edmund-release-and-operate -g -y
列出 Edmund Markdown 编辑器超越当前技术水平的开放研究课题。聚焦产品优先，提供每个前沿的 SOTA 缺陷、项目优势及具体验证步骤。用于评估新想法价值或指导研发方向，非执行已批准调查。
评估新研究方向的价值
寻找突破现有技术瓶颈的方案
确定下一个重大研发问题
npx skills add I7T5/Edmund --skill edmund-research-frontier -g -y
指导如何将直觉转化为可交付的修复方案，涵盖证据标准、假设预测及分析技巧。用于评估漏洞机制、验证结论可信度或证明修复有效性。
形成关于漏洞机制的假设时
评估调查结论的可信度时
决定修复是否经过证实时
将想法转化为已接受的变更时
npx skills add I7T5/Edmund --skill edmund-research-methodology -g -y
指导在 Edmund 编辑器中如何构建测试与验证证据。强调无头测试不足，需根据变更类型选择窗口测试、复现脚本或像素对比等更强证据。涵盖 Swift Testing 框架使用、测试套件结构及视觉 QA 流程。
编写或调整测试用例
判断修复所需的证明强度
解释测试套件结构
添加金标准或回归检查
npx skills add I7T5/Edmund --skill edmund-validation-and-qa -g -y
面向 Edmund Markdown 编辑器的 AppKit TextKit 2 参考文档。解析核心对象模型、视口布局机制及高度估算导致的视图抖动问题，提供具体代码指针与缓解策略，辅助处理布局、选择、IME 等复杂行为。
处理文本布局或滚动异常
排查视口抖动或高度估算错误
涉及 NSTextLayoutManager 或 TK2 机制时
npx skills add I7T5/Edmund --skill textkit2-appkit-reference -g -y
定义Edmund Markdown编辑器的架构契约，强制在重大代码变更、新机制设计或涉及TextKit 2底层操作前使用。核心在于维护存储与源码一致性及渲染管线规范，旨在解决光标漂移等历史痛点。
进行非 trivial 的代码变更前
询问系统为何如此构建时
提议新机制、子系统或重构时
处理 NSTextView/LayoutManager/Overlay 相关逻辑时
设计存储同步、选择、撤销或视口逻辑时
npx skills add I7T5/Edmund --skill edmund-architecture-contract -g -y
Edmund macOS应用的构建与环境配置指南。涵盖从0到1的环境搭建、SwiftPM核心命令使用、build-app.sh脚本解析及代码签名流程。重点解决构建陈旧、LaTeX渲染崩溃、Sparkle框架异常等常见问题，确保二进制文件安全可用。
从零开始克隆仓库或在新机器上配置开发环境
构建失败或构建结果未生效（如旧代码仍在运行）
应用启动时崩溃或LaTeX渲染瞬间崩溃
需要构建用于实时调试的EdmundDbg.app包
在信任并运行刚构建的二进制文件前进行安全检查
npx skills add I7T5/Edmund --skill edmund-build-and-env -g -y
针对Edmund编辑器中删除漂移类（光标/选区完整性）问题的决策门控排查流程。涵盖日志签名分类、已决防御验证、证据链回溯、确定性复现脚本构建及解决方案验证，确保修复通过字节级校验与自动化测试。
删除或输入后光标位置错误
文本编辑导致状态不同步
自动保存写入陈旧内容
日志出现LEN-MISMATCH警告
npx skills add I7T5/Edmund --skill edmund-caret-integrity-campaign -g -y
定义Edmund仓库变更分类、门禁及审查规则。涵盖文档、代码逻辑、视觉渲染及编辑流水线等变更类型的验证要求（如测试、截图、现场复现），确保变更安全合规，防止历史事故重演。
准备修改Edmund仓库代码或配置时
不确定变更是否需要测试、截图或现场复现时
执行提交、分支创建、合并或发布操作前
处理涉及UI绘制、选择行为或依赖变更的任务时
npx skills add I7T5/Edmund --skill edmund-change-control -g -y
Edmund Markdown编辑器配置与参数目录。涵盖UserDefaults设置、启动参数、编译时开关及日志配置，用于添加/修改设置、调试或审计默认值。强调代码为真理来源，需通过grep验证。
添加新偏好设置
排查功能行为对应的标志位
使用调试参数启动应用
审计默认配置
npx skills add I7T5/Edmund --skill edmund-config-and-flags -g -y
Edmund应用Bug排查手册，提供症状到机制的初步分诊、日志分析、构建检查及已知Bug核对流程。适用于光标漂移、视图异常、渲染错误等问题的快速定位与复现，避免重复发现已知问题。
收到Edmund应用的Bug报告或意外行为反馈
需要快速分诊未知故障原因
排查光标位置错误或视图跳动问题
验证是否为已知未修复Bug
npx skills add I7T5/Edmund --skill edmund-debugging-playbook -g -y
负责Edmund项目的文档规范与写作指南。明确各事实的唯一归属文档（如ARCHITECTURE.md），规定调查文档模板、CHANGELOG格式及提交信息规范，指导新知识的归档位置。适用于编写、更新项目文档或决定事实存放路径，不用于代码修改或调试。
编写或更新项目文档（如README, ARCHITECTURE, CHANGELOG等）
决定新学到的知识点、Bug或功能建议应存放在哪个文档中
撰写主题调查报告或发布说明
npx skills add I7T5/Edmund --skill edmund-docs-and-writing -g -y
防止Edmund在对外宣传中过度承诺。确保所有公开声明均可由仓库和发布版验证，区分已证实与候选特性，指导营销文案、博客及竞品对比中的合规表述。
撰写面向外部的README、博客、发布说明或营销文案
将Edmund与其他编辑器（如Typora、Obsidian）进行对比
决定哪些主张可公开宣称，哪些仍属未验证
规划生态相关工作（许可证、应用目录等）
npx skills add I7T5/Edmund --skill edmund-external-positioning -g -y
记录Edmund编辑器重大Bug调查、死胡同及被撤销修复的历史档案。用于避免重复排查已知问题，涵盖光标漂移、滚动异常等症状的根因与证据，防止重蹈覆辙。
重新调查光标/选择区症状（如漂移、不同步）时
遇到视图/滚动故障（如跳动、无法上滚）时
提出可能已被尝试并撤销的修复方案前
Bug报告看起来似曾相识或测试通过但应用行为异常时
npx skills add I7T5/Edmund --skill edmund-failure-archaeology -g -y
用于测量和复现 Edmund 应用实时行为（如光标、IME、拖拽）的故障诊断技能。提供从单元测试到脚本注入的升级复现阶梯，包含 ReproScript 驱动、CGEvent 模拟及截图像素测量工具，解决无头测试无法覆盖的 AppKit 延迟状态问题。
涉及实时光标、IME 输入或拖拽行为的 Bug
单元测试无法复现的报告
需要读取诊断跟踪或驱动运行中的应用
需要从截图测量像素
npx skills add I7T5/Edmund --skill edmund-live-repro-and-diagnostics -g -y
用于审查GitHub PR，基于Edmund架构规范生成合并就绪清单。涵盖数据收集、验证存储与TextKit 2一致性、识别隐藏变更及CI门禁等陷阱，确保仅基于实际运行结果输出客观检查项，禁止擅自合并或评论。
用户请求评估或审查PR时
执行 /edmund-pr-review <PR编号> 命令时
npx skills add I7T5/Edmund --skill edmund-pr-review -g -y
用于 Edmund 应用发布与运维的指南。涵盖 CI 流程、版本递增、签名、DMG 制作及 Sparkle 更新故障排查。仅在维护者明确要求时执行，禁止自主操作。
需要发布或调试 Edmund 版本
版本号变更或打标签
Sparkle 更新失败或签名错误
DMG 构建问题或 Gatekeeper 报错
查看崩溃报告或日志
npx skills add I7T5/Edmund --skill edmund-release-and-operate -g -y
列出 Edmund Markdown 编辑器的前沿研究课题，旨在突破现有技术瓶颈。聚焦视口稳定与光标完整性等开放问题，提供具体实施步骤及可证伪的验证标准，辅助评估高价值研发方向。
选择下一个重大技术难题
评估激进想法的可行性
寻求超越当前最佳实践的方案
npx skills add I7T5/Edmund --skill edmund-research-frontier -g -y
指导将假设转化为可交付成果的研究方法论。包含证据门槛（解释所有现象及负例、经受证伪）、实验前预测数值、以及回溯追踪和低成本观察等分析食谱，确保修复方案经得起验证。
形成关于Bug机制的假设时
评估调查结论的可信度时
决定修复是否被证实时
将想法转化为已接受的变更时
npx skills add I7T5/Edmund --skill edmund-research-methodology -g -y
指导在 Edmund Markdown 编辑器中如何构建有效的验证证据。强调仅靠无头测试不足，需根据变更类型（如逻辑、布局、绘制或输入处理）选择从单元、窗口化测试到实时复现脚本及像素测量的组合证据，确保修复真正可靠。
编写或调整测试用例
决定修复所需的证明强度
判断变更是否已验证通过
添加金标准或回归检查
npx skills add I7T5/Edmund --skill edmund-validation-and-qa -g -y
AppKit文本系统参考，解释TextKit 2核心机制、视口布局原理及高度估算导致的滚动异常。针对Edmund编辑器提供底层原理与具体文件指针，辅助处理布局、选择、IME等复杂行为。
处理文本布局或视口渲染问题
调试NSTextView或TextKit 2异常行为
涉及选择修复、IME或事件处理逻辑
npx skills add I7T5/Edmund --skill textkit2-appkit-reference -g -y
