---
name: vaycentsun/sw-using-agiledevelopment
source: https://app.decimal.ai/s/vaycentsun-sw-using-agiledevelopment@1/SKILL.md
source_sha256: 52a9cc530861
---

<SUBAGENT-STOP>
如果你作为子 Agent 被分派执行特定任务，跳过此技能。
</SUBAGENT-STOP>

<EXTREMELY-IMPORTANT>
如果你认为有哪怕 1% 的概率某个技能可能适用于你正在做的事，你**绝对必须**调用该技能。

如果某个技能适用于你的任务，你别无选择。**你必须使用它。**

这不是可协商的。这不是可选的。你无法合理化地逃避它。
</EXTREMELY-IMPORTANT>

## 指令优先级

Agile Development 技能覆盖默认系统提示行为，但**用户指令始终优先**：

1. **用户的明确指令**（CLAUDE.md、GEMINI.md、AGENTS.md、直接请求）—— 最高优先级
2. **Agile Development 技能** —— 在与默认系统行为冲突时覆盖
3. **默认系统提示** —— 最低优先级

如果 AGENTS.md 说"不要用 TDD"而某个技能说"始终用 TDD"，遵循用户的指令。用户拥有控制权。

## 如何访问技能

**在 Claude Code 中：** 使用 `Skill` 工具。调用技能时，其内容会被加载并直接呈现给你——直接遵循它。绝不要用 Read 工具读取技能文件。

**在 Copilot CLI 中：** 使用 `skill` 工具。技能从安装的插件中自动发现。`skill` 工具与 Claude Code 的 `Skill` 工具工作方式相同。

**在 Gemini CLI 中：** 技能通过 `activate_skill` 工具激活。Gemini 在会话开始时加载技能元数据，并在需要时激活完整内容。

**在其他环境中：** 查看你平台的文档以了解如何加载技能。

## 平台适配

技能使用 Claude Code 工具名称。非 CC 平台：参见 `references/copilot-tools.md`（Copilot CLI）、`references/codex-tools.md`（Codex）以了解工具等效项。Gemini CLI 用户通过 GEMINI.md 自动获得工具映射。

**OpenCode 用户：** 当技能引用你没有的工具时，替换为 OpenCode 等效项：

| Claude Code 工具 | OpenCode 等效项 |
|-----------------|----------------|
| `TodoWrite` | `todowrite` |
| `Task` 工具配子 Agent | 使用 OpenCode 的子 Agent 系统 |
| `Skill` 工具 | OpenCode 原生 `skill` 工具 |
| `Read` | `read` |
| `Write` | `write` |
| `Edit` | `edit` |
| `Bash` | `bash` |
| `Grep` | `grep` |
| `Glob` | `glob` |
| `WebFetch` | `webfetch` |
| `WebSearch` | （如需要，使用 `webfetch` 访问搜索引擎） |

# 使用技能

## 规则

**在做出任何回应或行动之前调用相关或被请求的技能。** 即使只有 1% 的概率某个技能可能适用，你也应该调用该技能来检查。如果被调用的技能结果不适用于当前情况，你不需要使用它。

### 简单任务快速通道

**只有满足以下条件的任务，才能跳过 requirements-clarification 和 writing-specs，直接调用 `sw-test-driven-dev`：**

- 纯配置/环境变更（如 `.env`、CI 配置、依赖版本号）
- 纯文档/注释更新（README、API 文档、代码注释）
- 拼写、格式、命名等表面层修复
- 单一文件内的单函数逻辑修复，且**用户已提供具体修复方案**
- 用户明确说"直接改"或"别走流程"

**以下情况一律不走快速通道，必须走完整流程：**
- 新增功能、组件、接口、模块
- 涉及多文件修改或跨模块影响
- Bug 根因不明确，需要调试/排查才能定位
- 涉及数据库 schema、API 契约、配置结构变更
- 删除或重构现有代码
- 任何需要 Agent 自行判断"范围大小"的任务

**不满足快速通道条件？** 走完整流程：sw-requirements-clarification → sw-technical-spec → sw-working-plan → sw-subagent-development。

```mermaid
flowchart TD
    Start1[收到用户消息] --> Check{可能有技能适用？}
    Start2[即将进入计划模式？] --> RequirementsClarified{已经完成需求澄清？}
    RequirementsClarified -->|否| Simple{简单任务？}
    RequirementsClarified -->|是| Check
    Simple -->|是| InvokeTDD[直接调用 sw-test-driven-dev]
    Simple -->|否| CallBrain[调用 sw-requirements-clarification]
    CallBrain --> WriteSpec[调用 sw-technical-spec]
    WriteSpec --> CreatePlan[调用 sw-working-plan]
    CreatePlan --> Dev[调用 sw-subagent-development]
    Dev --> Check
    InvokeTDD --> Announce
    Check -->|是，哪怕 1%| Invoke[调用 Skill 工具]
    Check -->|绝对不是| Respond[回应（包括澄清问题）]
    Invoke --> Announce[宣布：使用 skill 来 目的]
    Announce --> HasChecklist{有检查清单？}
    HasChecklist -->|是| Todo[创建 TodoWrite 待办]
    HasChecklist -->|否| Follow[严格遵循技能]
    Todo --> Follow
```

## 红旗 - 停止并检查技能

这些想法意味着停止——你在合理化：

| 想法 | 现实 |
|------|------|
| "这只是个简单问题" | 简单任务用快速通道（直接 TDD），不是跳过技能。 |
| "我需要更多上下文先" | 技能检查先于澄清问题。 |
| "让我先探索代码库" | 技能告诉你 HOW 探索。先检查。 |
| "我可以快速检查 git/文件" | 文件缺乏会话上下文。检查技能。 |
| "让我先收集信息" | 技能告诉你 HOW 收集信息。 |
| "这不需要正式技能" | 如果技能存在，使用它。 |
| "我记得这个技能" | 技能会演进。读取当前版本。 |
| "这不算是任务" | 行动 = 任务。检查技能。 |
| "这技能大材小用" | 简单任务用快速通道，复杂任务走完整流程。 |
| "我先做这一件事" | 在做任何事之前先检查。 |
| "这感觉很 productive" | 无纪律的行动浪费时间。技能防止这个。 |
| "我知道那是什么意思" | 知道概念 ≠ 使用技能。调用它。 |
| "简单任务不需要 requirements-clarification" | 正确。简单任务走快速通道，直接 TDD。但复杂任务必须 requirements-clarification。 |

## 常见借口表

| 借口 | 现实 |
|------|------|
| "这个任务太简单，不需要技能" | 简单任务走快速通道（TDD），仍然需要技能 |
| "我已经知道怎么处理" | 技能会演进。读取当前版本，不凭记忆 |
| "先做完这一件事再检查技能" | 在做任何事之前先检查。事后检查 = 已犯错 |
| "技能检查浪费时间" | 10 秒检查可能节省数小时返工 |
| "这个场景太特殊，没有对应技能" | 即使 1% 概率适用也要检查。你可能错了 |
| "简单任务不需要走完整流程" | 正确。快速通道允许跳过 requirements-clarification，但仍需 TDD |

## 技能优先级

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

1. **流程技能优先**（requirements-clarification、debugging）—— 这些决定 HOW 接近任务
2. **实现技能其次**（frontend-design、mcp-builder）—— 这些指导执行

"让我们构建 X" → requirements-clarification 优先，然后实现技能。
"修复这个 Bug" → debugging 优先，然后领域特定技能。

## 技能类型

**刚性**（TDD、debugging）：精确遵循。不要淡化纪律。

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

技能本身会告诉你属于哪种。

## 术语规范

本框架使用特定的中英文术语约定，所有 SKILL.md 文件和对用户输出必须遵循 `docs/terminology.md` 中的规范。关键术语摘要：

| 中文 | 英文（保留） | 说明 |
|------|-------------|------|
| 技能 | **Skill** | 框架核心概念，但 sw-using-agiledevelopment 等少数引导文件中保留英文 |
| 智能体 | **Agent** | AI 编程助手 |
| 子智能体 | **Subagent** | 被分派执行任务的 Agent 实例 |
| 业务规范 | **business-spec** | `docs/sw-agiledevelopment/business-specs/` 中的文档 |
| 技术规范 | **technical-spec** | `docs/sw-agiledevelopment/technical-specs/` 中的文档 |
| 实施计划 | **working-plan** | `docs/sw-agiledevelopment/plans/` 中的文档 |
| 规范（泛指） | **spec** | 泛指 business-spec 或 technical-spec |
| 待办事项 | **TODO** | 也可写 TODO |
| 令牌 | **token** | 上下文令牌 |

**规则**：首次出现时标注 `英文（中文）`，后续直接使用英文。严禁同一文档内混用。

## 用户指令

指令说的是 WHAT，不是 HOW。"添加 X" 或 "修复 Y" 并不意味着跳过工作流。