SuperAPI AI 工具集

pragmatic-coding-session

编程与开发

查看项目

更新于 10-16 08:02

技能介绍

用途:这是一个按阶段应用的操作镜头,用于在真实代码库中推进编码工作,目标是在当前仓库内取得务实掌握:承担责任、让系统更易修改、优先反馈而非猜测,并留下清晰痕迹。它并非书籍摘要,而是把务实编程的持久实践转化为决策、检查和验证。

主要能力与用法:先定位当前阶段——规划、设计、实现、调试、审查或交接。无论哪个阶段,只要改动触及状态、资源或信任边界,就执行可靠性与安全检查。流程为:先检查真实代码、测试、文档、运行时行为和仓库指引,再用一句话命名实际问题,然后找到能产生学习的最小可逆动作,把不确定性转化为示踪物、原型、测试、断言、日志或明确问题,保持代码比到达时更易修改,并用最省成本的检查验证行为、契约或风险。

分阶段要点:规划阶段分离用户成果与所请求机制,识别受影响的人与系统,把未知转为可答复的问题,集成风险高时倾向薄端到端示踪物,设计不清晰时用一次性原型,按可观察交付物分解估算,把完成定义为行为加验证。设计阶段为本代码库优化可变更性,关注知识重复而非文本重复,保持独立关注点独立,让决策可逆,在重要边界定义契约。实现阶段小步进行,避免巧合编程,保持快速反馈,用断言而非注释表达可检查的期望。调试阶段先复现,陈述预期与实际及最小失败案例,逐变量改动,修复根因并补回归检查。可靠性与安全阶段识别真相来源与不变量,检查资源归属,为重试、重复投递、部分失败、取消和回滚做设计,让失败可见。审查阶段对比差异与目标,查找熵增,验证边界情况,趁上下文新鲜简化。交接阶段尽早沟通假设与权衡,让下一步行动明确,留下有用的线索。

输出契约:当该技能影响一次编码会话时,按需包含阶段、务实框架(实际问题与所选最小有用动作)、决策、风险检查、验证与交接。

限制:不要把它变成冗长清单堆砌,只应用真正相关的阶段;不要引用或重构原书文本,不要嵌入章节笔记;不要把务实等同于快速草率;除非经过刻意加固,不要把原型当生产代码;在找到所保护的变化点之前不要添加抽象。资料未提供具体安装命令、收费或平台信息。