whetstone
理念(执行时理解「为什么」)
- 磨刀石比喻:输入(原文/案例)是磨刀石,阅读时的火花即批注;不追求「读完」,追求「有火花处就停笔」。
- 人机分工:批注来自人(读者书写,保留原话、仅做必要润色);本技能在已有「原文 + 批注」前提下,负责编号、对应原文、格式、「AI 总结分析」与文末贴「原文」。
Instructions(分步说明)
-
确认输入
若缺少原文或批注,向用户索要:「请提供原文(或链接 + 正文)以及你的批注(批注为人类的笔记,可注明每条对应的原文位置)。」 -
解析批注与对应关系
- 若用户已标明某条批注对应某段原文,按用户标注关联。
- 若未标明,根据批注内容与原文做合理匹配;若无法匹配则「对应原文」可写「见全文」或摘一句最相关句。
-
生成结构化文档
- 标题格式(文档主标题或建议文件名):
[YYYY-MM-DD] [Emoji] 主题:副标题。无#,主副标题统一用中文冒号:(不用——、-)。 - 文件名兼容 Windows:文件名中不得出现 ASCII 双引号
";若标题含引号内容,用直角引号「」代替(如"生命没有迭代机会"→「生命没有迭代机会」)。成对替换:第 1 个"→「,第 2 个"→」,依此类推。
- 标题格式(文档主标题或建议文件名):
More from qiao-925/qiao-skills
agent-skill-rules
Agent Skills 开放标准与治理规则。用于 skill 的创建、修改、重构、迁移、审计与维护,并在创建前判断需求应落到自动化、项目级规则、通用或项目私有 skill 还是单次 prompt,提供平台无关的结构标准、frontmatter 规范、渐进式披露与质量门禁。
35python-coding-standards
Python 实现基线能力单元,帮助 Agent 在 Python 代码实现、修改、补全、重构与审查场景中,先对齐项目既有约定,再落实类型边界、日志纪律、命名与结构可读性,避免把个人偏好或项目私货写成通用规范。关键词:Python、编码规范、类型提示、日志、命名、代码结构、项目对齐。
23critical-thinking-guidance
规范 Agent 在解答前进行智能判断与思考引导,避免不必要的替代思考并保留用户主导权。适用于用户提问、方案咨询、学习交流等需要平衡效率与思考深度的场景。关键词:引导提问、智能判断、轻量引导、强制思考
21single-responsibility
单一职责能力单元,帮助 Agent 在文件拆分、函数重构、模块设计、代码审查与边界澄清场景中,识别职责混杂、变化原因耦合与命名失真问题,让文件、函数、类与模块都能围绕一个稳定职责组织。关键词:单一职责、职责拆分、边界澄清、重构、文件拆分、函数重构、模块设计。
20architecture-governance
架构治理能力单元,帮助 Agent 在架构评审、重构、新模块设计、分层边界调整、接口契约设计与项目初始化分析场景中,检查分层与依赖方向、变更影响面、接口契约与可替换性,避免跨层耦合、反向依赖与破坏性演进。关键词:架构治理、分层、依赖方向、影响面分析、接口契约、依赖注入、可插拔、重构。
19core-first-simplicity
核心优先的复杂度控制能力单元,帮助 Agent 在项目取舍、架构设计、模块重构、实现裁剪与方案收敛场景中,先识别主亮点、控制复杂度预算、稳定主路径、延后非核心扩张,避免过度设计与大而全实现。关键词:核心优先、复杂度控制、KISS、方案收敛、过度设计、主路径。
19