using-zjkycode

name: using-zjkycode description: Use when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

指令优先级

zjkycode skills 覆盖默认系统提示行为，但用户指令始终优先：

1. 用户明确指令（CLAUDE.md、GEMINI.md、AGENTS.md、CODE_AGENT.md、直接请求）— 最高优先级
2. zjkycode skills — 在冲突处覆盖默认系统行为
3. 默认系统提示 — 最低优先级

如果 CLAUDE.md、GEMINI.md 、CODE_AGENT.md 或 AGENTS.md 说"不要使用 TDD"，而某个 skill 说"始终使用 TDD"，请遵循用户指令。用户拥有控制权。

如何访问 Skills

使用 Skill 工具。当你调用 skill 时，其内容会被加载并呈现给你 — 直接遵循它。永远不要使用 Read 工具读取 skill 文件。

使用 Skills

规则

在任何响应或操作之前调用相关或请求的 skills。 即使只有 1% 的可能性某个 skill 适用，你也应该调用该 skill 进行检查。如果调用的 skill 最终不适用于当前情况，你不需要使用它。

digraph skill_flow {
    "用户消息已收到" [shape=doublecircle];
    "即将进入计划模式？" [shape=doublecircle];
    "是否已进行头脑风暴？" [shape=diamond];
    "调用头脑风暴技能" [shape=box];
    "是否有任何技能可能适用？" [shape=diamond];
    "调用技能工具" [shape=box];
    "声明：'正在使用 [技能] 来 [目的]'" [shape=box];
    "是否有检查清单？" [shape=diamond];
    "为每一项创建 TodoWrite 待办事项" [shape=box];
    "严格遵守技能执行" [shape=box];
    "回复（包括澄清说明）" [shape=doublecircle];

    "即将进入计划模式？" -> "是否已进行头脑风暴？";
    "是否已进行头脑风暴？" -> "调用头脑风暴技能" [label="否"];
    "是否已进行头脑风暴？" -> "是否有任何技能可能适用？" [label="是"];
    "调用头脑风暴技能" -> "是否有任何技能可能适用？";

    "用户消息已收到" -> "是否有任何技能可能适用？";
    "是否有任何技能可能适用？" -> "调用技能工具" [label="是，即使只有1%的可能"];
    "是否有任何技能可能适用？" -> "回复（包括澄清说明）" [label="完全没有"];
    "调用技能工具" -> "声明：'正在使用 [技能] 来 [目的]'";
    "声明：'正在使用 [技能] 来 [目的]'" -> "是否有检查清单？";
    "是否有检查清单？" -> "为每一项创建 TodoWrite 待办事项" [label="是"];
    "是否有检查清单？" -> "严格遵守技能执行" [label="否"];
    "为每一项创建 TodoWrite 待办事项" -> "严格遵守技能执行";
}

危险信号

这些想法意味着停止 — 你在找借口：

Skill 优先级

当多个 skills 可能适用时，使用此顺序：

1. 流程 skills 优先（brainstorming、debugging）— 这些决定如何处理任务
2. 实现 skills 其次（frontend-design、mcp-builder）— 这些指导执行

"让我们构建 X" → 先 brainstorming，然后实现 skills。 "修复这个 bug" → 先 debugging，然后领域特定 skills。

Skill 类型

严格的（TDD、debugging）：精确遵循。不要偏离规范。

灵活的（patterns）：根据上下文调整原则。

Skill 本身会告诉你属于哪种类型。

用户指令

指令说的是做什么，而不是怎么做。"添加 X" 或 "修复 Y" 不意味着跳过工作流程。

<强制工作流>

任务分类与工作流

根据任务类型，必须严格遵循对应的工作流程：

构建类任务完整工作流

对于任何"创建/构建/添加/实现/开发"类任务，必须严格按以下顺序执行：

步骤 1: brainstorming（头脑风暴）
        │
        ├─ 理解需求和约束
        ├─ 探索方案（2-3种）
        ├─ 展示设计获得用户批准
        └─ 输出：设计文档
        │
        ▼
步骤 2: writing-plans（编写计划）
        │
        ├─ 创建详细实施计划
        ├─ 定义文件结构、任务分解
        └─ 输出：实施计划文档
        │
        ▼
步骤 3: 执行
        │
        ├─ subagent-driven-development（推荐）
        │   每个任务派发子代理(支持cli-agent,需要询问用户使用哪种) + 两阶段审查
        │
        └─ executing-plans（备选）
            批量执行 + 检查点审查
        │
        ▼
步骤 4: code-review（代码审查）
        │
        ├─ 每个功能/任务完成后自动触发
        └─ 用户明确要求时触发
        │
        ▼
步骤 5: verification-before-completion（完成前验证）
        │
        ├─ 运行测试命令，验证通过
        ├─ 检查需求清单，确认完成
        └─ **没有验证证据不得声称完成**
        │
        ▼
步骤 6: finishing-a-development-branch（完成分支）
        │
        └─ 合并/PR/清理工作树

每个步骤的输出是下一个步骤的输入，未经豁免不得跳过。

调试类任务工作流

步骤 1: systematic-debugging（系统化调试）
        │
        ├─ 阶段1: 根本原因调查（阅读错误、复现、收集证据）
        ├─ 阶段2: 模式分析（找工作示例、对比差异）
        ├─ 阶段3: 假设和测试（最小化测试、验证）
        └─ 阶段4: 实现（创建失败测试、修复、验证）
        │
        ▼
步骤 2: test-driven-development（TDD）
        │
        └─ 编写测试验证修复
        │
        ▼
步骤 3: code-review（代码审查）
        │
        ▼
步骤 4: verification-before-completion（完成前验证）
        │
        └─ 验证 bug 已修复，无回归

铁律：没有根本原因调查就不能提出修复方案。

UI/前端任务特殊要求

涉及以下内容时，必须使用 craft-studio（视觉设计）技能：

• UI 界面设计
• 前端布局
• 图标设计
• 视觉原型
• 交互设计

UI类任务工作流：

brainstorming
    │
    ├─ 提供视觉伴侣（单独消息）
    │   "我们正在处理的内容，如果可以在浏览器中展示会更易于理解..."
    │
    ├─ 使用浏览器展示模型、线框图、布局比较
    │
    └─ 继续正常工作流 → writing-plans → ...

强制技能与可选技能

强制技能（必须调用）

可选技能（按需调用）

用户豁免条件

只有当用户明确表达以下意思时，可以跳过 brainstorming + writing-plans：

• "直接做，不需要计划"
• "跳过计划"
• "不用写计划了"
• "简单做就行，不需要头脑风暴"
• "我已经想好了，直接实现"

注意：

• 用户说"简单"或"快速"不等于豁免
• 用户说"这个功能很简单"不等于豁免
• 只有明确的"跳过计划/不需要计划"指令才有效

豁免后仍需执行：

• verification-before-completion（完成前验证）
• code-review（代码审查，除非用户也明确跳过）

代码审查触发条件

必须触发代码审查：

1. 每个功能/任务完成后
2. 合并到主分支前
3. 用户明确要求时

代码审查流程：

1. 获取 git SHA（base 和 head）
2. 派发 code-reviewer 子代理
3. 根据反馈修复问题
4. 验证修复有效

危险信号（停止并检查）

非常重要: 严格按照技能指导走! </强制工作流>