Sextant是一个为Claude Code设计的、具备架构意识的工程原则框架。它旨在解决现有代码库的实际工作需求,例如bug修复、功能开发、代码重构、代码审查和数据迁移等。与将所有请求一概而论不同,Sextant根据任务类型进行工作路由,应用与变更规模相匹配的规则,并明确指出原则冲突,而非让开发者自行猜测。
为什么需要Sextant?
如果你曾将Claude Code用于严肃项目而非简单的玩具项目,可能会发现它常出现一些模式化的问题。
有时,Claude Code过早地开始编辑。它可能读取错误追踪,打开一个附近函数,然后直接着手修复,却未能真正定位到问题的根本原因。
还有些时候,它会忽视现有系统的架构。当你要求添加一个新功能时,它不是在现有模式上进行扩展,而是发明一种全新的实现方式。
再者,它有时会应用不恰当的流程。一个微小的局部改动可能被当作一项复杂的架构设计任务来处理,而一个跨模块的重大变更却可能被当作一个简单的单文件补丁来对待。
Sextant的核心理念很简单:首先建立一个安全的基线,然后确定任务类型,最后应用适用于该类变更的规则。其目标不是增加繁琐的仪式化步骤,而是帮助Claude Code在修改代码之前做出更明智的决策。
按任务类型路由,而非单一通用工作流
Sextant并非一个单一的、庞大的提示词集合。它由一系列专业化的子技能组成,Claude Code能够自动将用户的请求匹配到最相关的子技能上。
这一点至关重要,因为bug修复不应与代码迁移混为一谈,代码审查也不应等同于功能实现。
以下是其高层结构:
| 任务类型 | 子技能 | 关键行为 |
|---|---|---|
| Bug修复 | sextant:fix-bug | 消歧门控 → 精准微改 → 确认门控 |
| 新功能 | sextant:add-feature | 架构研究 → 集成策略 → 可选TDD |
| 修改/重构 | sextant:modify-feature | 消歧门控 → 影响分析 → 确认门控 |
| 代码审查 | sextant:review-code | 声明审查模式 → 多维度审查 → 分类输出 |
| 调试 | sextant:debug | 二分法协议 → 假设限制门控 → 移交至bug修复 |
| 安全审计 | sextant:security | 输入验证、认证/授权、敏感数据与依赖审查 |
| 迁移 | sextant:migrate | 叶优先迁移序列 → 每模块验证 |
| 冲刺规划 | sextant:plan | 依赖排序任务列表 → 执行管道入口 |
| 发布/PR准备 | sextant:ship | 发布前检查清单 → PR描述生成 |
| 编写测试 | sextant:write-tests | Bug复现测试入口 → 边界矩阵设计 |
| 需求 | sextant:refine-requirements | 消除歧义 → 可行性评估 → 任务分解 |
| 通用编码 | sextant | 轻量级任务及豁免场景 |