base

base skill 概览

base skill 的作用

base skill 是 coding 工作的基础层：它会先推动你建立简单结构、坚持 TDD 优先、把任务拆到足够小，再避免你滑向过度设计。如果你需要一个能帮助 agent 做更小的设计决策、保持文件可读、降低重写风险的 base skill，这正是它要解决的问题。

最适合哪些用户

当你需要一个日常实现工作的实用护栏时，尤其是在 greenfield repo、重构场景，或者 AI 辅助编码过程中任务范围很容易失控时，base skill 很适合使用。它最适合重视可维护性、而不是追求炫技的团队。

它有什么不同

这个 base guide 最强的信号不是某种花哨框架，而是硬性限制和执行约束。repo 强调简单性规则、行数限制、文件边界，以及 TDD workflow，从而让 agent 的自由度更小。也因此，base for Code Editing 更适合稳定、可重复的修改，而不是开放式头脑风暴。

如何使用 base skill

正确安装并加载

对于目录条目，预期的安装路径是 npx skills add alinaqi/claude-bootstrap --skill base。由于源文件里这个 skill 被标记为 always-loaded，安装 base 时应把它当作在开始编辑前就要启用的基础层，而不是一次性的 prompt 片段。

把粗糙任务改写成好 prompt

base 最适合的 prompt 会明确说明目标文件、变更目标和约束类别。像“clean this up”这种弱请求会引发大范围重写；更好的 base 使用方式是：Refactor src/auth/session.ts to separate validation from persistence, keep each function under 20 lines, preserve current tests, and add tests first for the new error cases.

先读这些文件

先看 SKILL.md 理解规则，再在编辑前检查 repo 中相邻的约定。这个 repository 里没有像 rules/ 或 resources/ 这样的辅助文件夹，所以主要的决策面就集中在 skill 文件本身，以及目标代码库里的相关项目文件。

适合这个 skill 的工作流

把 base 当成一个顺序流程来用：先找出最小变更，再写或更新 tests，然后用紧凑函数实现，最后在收尾前检查行数和依赖限制。如果任务没法再缩小，就把它拆成多个原子化 todos，而不是硬把一个大 patch 一次性推过去。

base skill 常见问答

base skill 自己就够用吗？

可以，只要你需要的是 coding 基线，而不是某个领域专用工具。base skill 的设计目标是尽可能通用，但如果配合明确的项目 prompt 和现有 repo 上下文，它的效果会更强。

什么时候不该用 base？

当任务是探索性的、强视觉驱动的，或者本来就是偏 prototype、此时还不太在意结构时，就不该用它。如果你的目标是无论如何先快，base skill 的这些约束就可能显得很束缚。

这比普通 prompt 更好吗？

在 code editing 工作里，通常是的，因为 base guide 给了 agent 具体边界，而不是空泛的风格建议。普通 prompt 只能说“write clean code”，但 base 会补充可衡量的约束，比如函数大小、嵌套深度和文件作用域。

base 适合初学者吗？

适合，因为规则明确，而且很容易检查。初学者最大的风险，是在没有真正理解问题的情况下过度套用这些限制，所以应该从最小、最有用的变更开始，而不是一次性把所有东西都重构掉。

如何改进 base skill

给 skill 更精确的输入

提升 base 结果的最好办法，是把文件名、目标行为和编辑边界说清楚。Fix the login flow 太弱；Update login.ts so token parsing is isolated, add tests for expired tokens, and keep the public API unchanged 会给 skill 一个更明确的目标。

要求正确的取舍

如果可读性比最小 diff 更重要，就直接说明。如果必须先更新 tests 再实现，也要明确说出来。base skill 在你告诉它哪个约束不可妥协时，响应会更好，而不是指望它自己猜出优先级。

检查这些常见失败模式

注意过度拆分、隐藏耦合，以及那种虽然满足行数限制、却削弱命名或模块边界的修改。如果第一版过于抽象或过于碎片化，就要求第二轮把琐碎 helper 合并掉、去掉重复，并保持执行路径一眼能看懂。