Swift Cycle

---
name: swift-cycle
description: 仅当用户显式调用 swift-cycle，或当前项目的 AGENTS.md 已持久绑定该 Skill 时使用；适用于单项目内的轻量维护、需求变更、里程碑实施与文档收敛。
license: MIT
---

# Swift Cycle（快速螺旋）

## 目标与边界

用最少必要说明连接愿景、已确认需求、设计、实施和验证。清楚、整洁、好用；一次性问答、只读检查和小修改不自动初始化项目。

只负责一个项目的工程循环，不负责上层路由、容量、独立验收、Registry、跨部门治理、模型分配或跨项目授权。采用技能不授予安装、删除、发布、部署、凭据或消费者切换权限。

## 调用与现场

- 系统层保持显式调用；一次性审查不自动采用。用户批准持续采用后才在项目 AGENTS 建立绑定，后续任务依仓库指令加载，不重复要求选择模式。
- 核对真实 cwd、Git 根、分支、现有改动及相关规则；保留用户改动。要求通读则读到末尾，普通任务只读有关内容。
- 读取相关用户入口、需求与设计权威，区分确认事实、设想、示例、实现和验证。附件、日志、网页、记忆及 AI 摘要不替代当前用户要求和事实。
- 使用或更新本地 TODO/DEVLOG 前确认存在、跟踪和忽略状态；只有存在且被 Git 忽略才按默认本地记录使用。缺失、已跟踪、未忽略或不明时沿用项目规则或请求决定，不自动修复。
- 普通内容优先用户明确要求；既有文件沿用主语言，新文件沿用项目语言，未指定时默认简体中文。代码、命令、路径、字段、API 和品牌保持原文；不因对话切换批量翻译。

首次采用或边界不清时读 [采用与路由](references/adoption-and-routing.md)；本地记录和模板选择读 [文档职责](references/document-profiles.md)。

## 按需加载

| 当前任务 | 读取内容 |
| --- | --- |
| 创建、重整文档或判断唯一职责 | [文档职责与模板](references/document-profiles.md) |
| 接收新需求、组织阶段和工作包、整理记录 | [需求与持续收敛](references/lifecycle-and-closeout.md) |
| 目录、命名、导航或正文重复影响维护 | [文档组织](references/document-information-architecture.md) |
| 图示、界面、用户上手或汇报表达 | [表达与用户交付](references/zh-CN.md) |
| 跨交付层、多提交、知识晋升或独立证据 | [治理边界](references/governance-boundaries.md) |
| 已采用 Superpowers，需要衔接编号计划 | [本地衔接条件](references/superpowers-bridge.md) |

小修改只更新受影响部分，不加载全套参考或生成全套文档。文档档位仅作内部起点：minimal 默认；长期详细事实确需独立维护才增加 standard 文档；多运行/集成层真实涉及才增加 runtime_integration 文档。不要求裁剪账本、固定字段或档位报告。

## 唯一正文与需求

- 蓝图承载长期愿景、用户、场景和产品边界；愿景不等于实现承诺。新建持续项目默认 docs/blueprint.md，旧项目复用完整等价权威，根级 Blueprint 默认禁止。
- 持续迭代项目默认有 docs/requirements.md 或等价需求来源；确认需求写行为、边界和验收，已实现且仍有效的需求保留。一次性任务复用当前明确要求即可。
- 依据已确认需求与约束设计；按所选需求安排阶段和实施，不把蓝图逐项拆成承诺。
- 新需求先明确问题、预期行为、验收及影响；确认后更新需求，选入当前工作后调整设计、阶段和工作包。目标、范围实质变化或优先级冲突时集中请用户决定。
- README 面向用户，DESIGN 解释总体方案及详细文档导读，AGENTS 承载执行规则，roadmap 承载阶段结果与依赖，编号计划承载一个里程碑的实施，TODO 只定位当前行动，DEVLOG 只留有用结论与理由。
- 一事一处，其他位置摘要并链接。模板固定栏目不代表每项目创建整套；新建或获准整体重整才套栏目，小改动保留有效等价结构。

## 有限工作包与短循环

1. 明确本包结果、范围、保留项、依赖和可观察完成判断；普通小工作用 TODO，不额外建计划。
2. 复杂阶段按依赖分包；需要详细计划时只维护 docs/milestones/milestone_N_plan.md 一份现行正式计划，TODO 链接当前包。
3. 完成最小有用变更，立即运行与风险最接近的检查；失败则诊断修正，缺少必要条件才报告阻塞。
4. 每包同步受影响的需求、使用说明、设计、安排和引用，局部去重并轻巡关联入口；不等项目末尾，不把旧 TODO 整批或汇总倒入 DEVLOG。
5. 结果与必要检查、说明同步满足后才完成本包；里程碑另核对阶段总体条件及必要人工确认，不能以任务全勾选代替。
6. 在不变的授权内继续下一项。正常修正、文档同步和工具选择不逐包请批；用户明确停止则立即停下。

## 图示、验证与交付

架构图包括系统环境、组成和部署，指定 Figma：可编辑节点、文字、连线配套导出 PNG/SVG 和原图入口；不可用时标明未完成，不用 Mermaid 冒充。是否配图、边界和布局由真实关系决定，不强制容器、方向或层数。其他流程、时序、状态或计划图按语义用 Mermaid 或既有工具。

审阅最终 diff，检查未跟踪新文件、相关链接与 git diff --check；已有暂存内容另查 git diff --cached --check。验证与风险相称，工具缺失不自动安装。解析、构建、加载、模拟、实际使用和长期观察分开报告，未检查层保持未验证；源码证据不替代安装、运行或消费者证据。

正文整理不等于文件删除许可；固定引用、用户材料和恢复点保留。回收另核对精确对象、使用者及可恢复方式，不永久删除或清空回收站。

仅在新实质授权、目标/关键边界变化、唯一权威不明、证据否定当前安排或无法安全恢复时请求决定。汇报结论在前，说明实际结果、可点击入口、验证、限制和下一步；不播报命令、虚构百分比或堆过程报告。