Agent Skills
› Teaonly/SKILL.mk
Teaonly/SKILL.mk
GitHub一种极致压缩的通信模式，通过省略填充词、冠词和客套话，在保持技术准确性的前提下大幅降低 Token 消耗。适用于追求极简高效交互的场景。
安装全部 Skills
npx skills add Teaonly/SKILL.mk --all -g -y
集合内 Skills (19)
一种极致压缩的通信模式，通过省略填充词、冠词和客套话，在保持技术准确性的前提下大幅降低 Token 消耗。适用于追求极简高效交互的场景。
用户要求使用 caveman 模式
指令 less tokens 或 be brief
npx skills add Teaonly/SKILL.mk --skill caveman -g -y
基于“设计两次”理念，通过并行子代理生成多种截然不同的接口设计方案，并进行对比与综合，帮助用户探索最佳 API 或模块接口设计。
用户想要设计 API
探索接口选项
比较模块形状
提到 'design it twice'
npx skills add Teaonly/SKILL.mk --skill design-an-interface -g -y
通过严格提问和场景推演，将计划与现有领域模型对比，统一术语并即时更新文档。用于压力测试设计、消除歧义及对齐业务语言。
用户希望验证设计计划是否符合项目领域模型
需要统一或澄清业务术语定义
要求根据上下文更新 CONTEXT.md 或 ADR
npx skills add Teaonly/SKILL.mk --skill domain-model -g -y
用于编辑和优化文章草稿，通过重组章节、提升清晰度和精简文本来改进内容。需先确认章节结构，再逐段重写以确保逻辑连贯和流畅性。
用户要求修改或润色文章
需要优化文章结构和表达清晰度
npx skills add Teaonly/SKILL.mk --skill edit-article -g -y
通过配置 Claude Code 的 PreToolUse 钩子，拦截并阻止危险的 Git 命令（如 push、reset --hard），防止误操作导致代码丢失或破坏。
用户希望防止破坏性 Git 操作
需要添加 Git 安全钩子
要求在 Claude Code 中阻止 git push/reset
npx skills add Teaonly/SKILL.mk --skill git-guardrails-claude-code -g -y
通过基于标签的状态机自动化处理GitHub Issue，包括分类、状态流转及冲突检测，辅助维护者进行问题分流与Agent准备。
创建Issue
Issue分流
审查Bug或功能请求
为AFK Agent准备Issue
npx skills add Teaonly/SKILL.mk --skill github-triage -g -y
分析代码库架构，识别浅层模块和耦合问题，提出重构建议以提升测试性和AI可导航性。结合上下文文档和ADR决策，利用删除测试等原则发现深度优化机会。
用户希望改进代码库架构
寻找重构机会
整合高耦合模块
提升代码可测试性或AI导航能力
npx skills add Teaonly/SKILL.mk --skill improve-codebase-architecture -g -y
将测试文件中的 as 类型断言迁移至 @total-typescript/shoehorn，通过 fromPartial/fromAny 实现类型安全的测试数据构造，消除冗余断言。
用户提及 shoehorn
需要替换测试中的 as 断言
需要构建部分测试数据
npx skills add Teaonly/SKILL.mk --skill migrate-to-shoehorn -g -y
用于在 Obsidian 知识库中搜索、创建和管理笔记。支持按文件名或内容检索，遵循特定命名规范与 wikilinks 链接语法，并协助查找相关笔记及索引文件。
用户需要搜索 Obsidian 中的笔记
用户想要创建新的笔记
用户需要整理或组织笔记结构
npx skills add Teaonly/SKILL.mk --skill obsidian-vault -g -y
交互式QA会话技能，用户通过对话报告问题，Agent澄清需求并后台探索代码库上下文，最终生成面向用户的GitHub Issue。适用于Bug报告、QA测试及Issue创建场景。
用户报告Bug或问题
进行QA测试
要求文件化Issue
提及QA session
npx skills add Teaonly/SKILL.mk --skill qa -g -y
通过用户访谈深入分析重构需求，评估代码现状与测试覆盖，制定细粒度增量提交计划，并生成包含问题、方案及决策的 GitHub Issue。
用户希望规划代码重构
创建重构 RFC
将重构拆分为安全的小步骤
npx skills add Teaonly/SKILL.mk --skill request-refactor-plan -g -y
用于创建符合规范的练习目录结构，包含问题、解答和说明文件。自动处理命名规范、生成存根README，并运行lint确保通过验证，适用于课程章节或习题集的初始化与脚手架搭建。
用户需要创建新的练习章节
用户希望生成习题存根结构
用户要求设置课程部分
npx skills add Teaonly/SKILL.mk --skill scaffold-exercises -g -y
用于在项目中配置 Husky pre-commit 钩子，集成 lint-staged、Prettier 格式化、类型检查和测试脚本，确保代码提交前自动执行质量检查。
用户希望添加 pre-commit hooks
需要设置 Husky 或 lint-staged
npx skills add Teaonly/SKILL.mk --skill setup-pre-commit -g -y
指导用户遵循TDD红绿重构循环进行开发。强调通过公共接口验证行为，采用垂直切片而非水平切片，优先测试关键路径和复杂逻辑，确保测试具备可维护性并能随重构存活。
使用TDD开发功能
修复Bug时要求测试先行
提及红绿重构流程
询问如何编写集成测试
npx skills add Teaonly/SKILL.mk --skill tdd -g -y
将计划、规范或PRD拆解为可独立执行的GitHub Issue，采用垂直切片方法确保端到端完整性。支持获取上下文、探索代码库、起草切片、与用户确认依赖关系及粒度，最终按依赖顺序创建Issue。
将计划或PRD转化为GitHub Issue
创建工作实现票据
将工作拆解为Issue
npx skills add Teaonly/SKILL.mk --skill to-issues -g -y
将对话上下文转化为产品需求文档（PRD）并提交为 GitHub Issue。通过分析代码库状态，定义问题、解决方案、用户故事及实施与测试决策，辅助需求梳理与文档化。
用户希望从当前上下文创建 PRD
需要将对话内容整理为结构化需求文档
npx skills add Teaonly/SKILL.mk --skill to-prd -g -y
该技能用于自动排查代码库中的Bug或问题，通过深入分析定位根因，并基于TDD原则制定红绿测试修复计划，最终自动生成包含问题分析与修复方案的GitHub Issue。
用户报告Bug
要求创建Issue
提及triage
需要调查并规划修复方案
npx skills add Teaonly/SKILL.mk --skill triage-issue -g -y
从对话中提取领域术语，消除歧义并生成统一词汇表，保存至UBIQUITOUS_LANGUAGE.md。适用于定义领域术语、构建 glossary 或提及 DDD 场景。
用户想要定义领域术语
用户提到 'domain model' 或 'DDD'
用户希望构建术语表
npx skills add Teaonly/SKILL.mk --skill ubiquitous-language -g -y
指导用户创建符合规范的 Agent Skill，涵盖需求收集、SKILL.md 编写、文件结构及描述优化，确保技能可被准确触发。
创建新的 agent skill
编写 SKILL.md 模板
设计 skill 结构
npx skills add Teaonly/SKILL.mk --skill write-a-skill -g -y
