{"id":"75b19b55-1c9b-44e9-9b47-8d46a60fc90c","shortId":"Pbet6u","kind":"skill","title":"sequential-thinking","tagline":"当复杂问题需要系统性逐步推理时使用。适用于多阶段分析、设计规划、问题分解，或初始范围不明确且需要受控收敛的任务。","description":"# Sequential Thinking\n\n这个 skill 的核心不是“多写几段 thought”，而是让 AI 在复杂问题里**持续推进、允许修正，并最终收敛成结论**。CLI 只是执行载体；skill 本身负责定义什么时候该进入这种思考方式，以及如何避免把顺序思考退化成松散输出。\n\n## Mission\n\n这个 skill 用来把复杂问题处理成一个**有边界、可修正、可复核的推理过程**：\n\n- 先澄清问题，而不是急着给答案\n- 在推进过程中允许修正和调整判断\n- 在复杂度上升时比较替代路径，而不是单线硬推\n- 在有限步数内收敛成结论与建议\n- 最后保留可回放的推理轨迹\n\n它解决的不是“不会想”，而是“想得太散、太早下结论、太难复核”。\n\n## Core Capabilities\n\n- **迭代推进**: 把复杂问题拆成连续步骤，而不是试图一口气得到完整答案\n- **动态修正**: 当新证据出现时，允许回看并修正前面的判断\n- **分支比较**: 当存在替代路径时，允许先比较再收敛\n- **上下文保持**: 在多步推理中维持清晰的问题边界与目标\n- **结论收束**: 最终必须形成判断，而不是无限发散\n\n## When to Use\n\n在以下场景调用：\n\n- 问题需要多个相互关联的推理步骤\n- 初始范围或方法不明确，需要先拆问题、再形成方法\n- 需要在有限候选方案之间做比较，而不是无限发散\n- 需要回看已有判断、识别漏洞、证据不足与隐含假设\n- 需要留下可回放、可导出的推理轨迹\n\n**不适用场景**：\n\n- 简单事实查询\n- 单步即可完成的任务\n- 路径已经非常明确、无需多步推演的问题\n- 纯头脑风暴且暂时不要求收敛的场景\n\n## Working Philosophy\n\n- **先找主问题，再找答案**：不要把现象描述误当作根因定位\n- **允许修正，而不是硬撑前提**：前面想错了，就回头修，不要带着错误前提继续推进\n- **先消除复杂度，再堆解决方案**：优先识别主矛盾，而不是抢着给补丁\n- **每一步只推进一步**：当前步只表达当前判断，不重复整套背景\n- **最终必须落到结论**：不能把“我还能继续想”当作默认出口\n\n## Installation & Runtime Model\n\n这个 skill 面向 agent 交付思考方式与调用约束；CLI 通过 npm 分发。\n\n在使用前，应先确保本地已安装对应 CLI：\n\n```bash\nnpm install -g sequential-thinking-cli\n\n# 或\npnpm add -g sequential-thinking-cli\n```\n\n安装后，使用 `sthink` 作为命令入口。\n\n## CLI Contract\n\n本 skill 不再要求 AI 手写 thought JSON。执行层通过 CLI 主路径动作完成：\n\n- `start`\n- `step`\n- `replay`\n\n### `start`\n\n只接受四个输入：\n\n- `name`\n- `goal`\n- `mode`\n- `totalSteps`\n\n约束：\n\n- `mode` 仅允许 `explore`、`branch`、`audit`\n- `totalSteps` 仅允许 `5` 或 `8`\n\n如果你不确定该选哪种模式，默认用 `explore`。只有在任务明显是在比较候选路径时才用 `branch`；只有在任务明显是在审查既有判断时才用 `audit`。\n\n### `step`\n\n只接受：\n\n- `content`\n\n其余上下文应由 runtime 自动恢复并注入。\n\n### `replay`\n\n用于读取已完成会话并生成 replay 文档；如需要，可额外导出到当前目录。\n\n## Recommended Workflow\n\n```text\n1. 先判断问题是否真的需要 sequential-thinking，而不是默认套用。\n2. 如需要，先安装或确认本地已有 npm CLI。\n3. 用 `sthink start` 给出 `name`、`goal`、`mode`、`totalSteps`。\n4. 用 `sthink step` 逐步推进，每一步只写当前推进内容。\n5. 当出现新证据时，允许修正，而不是硬撑旧判断。\n6. 到收敛阶段时，必须输出结论、风险与下一步建议。\n7. 完成后按需使用 `sthink replay` 生成与导出回放文档。\n```\n\n## Examples\n\n以下示例不是为了让你回去手写 JSON，而是为了说明这种 skill 真正有价值的地方：**如何推进、如何修正、如何收敛**。\n\n### Example 1: 基础推演\n\n```bash\nsthink start --name \"query-diagnosis\" --goal \"定位查询性能下降的主因\" --mode explore --totalSteps 5\nsthink step --sessionPath \"<session-path>\" --content \"先不要急着选优化手段。需要先把问题拆成几层：是单条 SQL 退化、接口级 N+1，还是更上层的调用放大。若根因没分清，后面的缓存、索引、重写都可能只是补丁。\"\nsthink step --sessionPath \"<session-path>\" --content \"从查询日志看，用户详情接口在一次请求里触发了大量重复读取，已经出现明显的 N+1 信号。但还不能直接下结论，因为重复查询也可能只是症状；需要继续确认慢点究竟来自“查询次数过多”，还是“某条关键查询本身很慢”。因此总步数上调一档。\"\nsthink step --sessionPath \"<session-path>\" --content \"结论可以收敛了：主因是列表页批量加载时触发的 N+1，次因是关联字段缺少索引放大了单次查询成本。优化顺序应该先消除 N+1，再补索引验证尾延迟；这样既先打掉主矛盾，也避免一上来引入缓存复杂度。\"\n```\n\n### Example 2: 修正前提\n\n```bash\nsthink step --sessionPath \"<session-path>\" --content \"回看 profiling 结果后，前面的判断需要修正：真正拖垮接口的不是 N+1 本身，而是关联列缺少索引，导致每次关联查询都在放大全表扫描成本。也就是说，N+1 仍然存在，但它不是第一性瓶颈，优先级应该后移。\"\n```\n\n### Example 3: 复杂变更拆解\n\n```bash\nsthink start --name \"change-impact-analysis\" --goal \"拆解复杂变更的影响与优先级\" --mode explore --totalSteps 5\nsthink step --sessionPath \"<session-path>\" --content \"用户一次性提出了多项规则修改，不该把它们当成同一种改动处理。先拆开看：有的是机制原则调整，有的是数值平衡，有的是接口语义变化，还有的是文档与实现脱节。如果不先分型，后面会把“该改 ADR 的”“该改设计文档的”“该补代码契约的”混成一锅。\"\nsthink step --sessionPath \"<session-path>\" --content \"先做影响矩阵。机制原则类改动通常会回流到 ADR 和 System Design；数值平衡会影响规则表、配置与测试基线；接口语义变化最危险，因为它会悄悄破坏调用方的假设。这里最该警惕的不是改动数量，而是有没有改到“被多个模块默认依赖、但文档里没写清楚”的隐性契约。\"\nsthink step --sessionPath \"<session-path>\" --content \"可以收敛了：先处理那些会改变系统边界或调用语义的项，再处理数值与体验层面的项。顺序上应优先修正文档与契约，再讨论平衡性；否则后续所有实现和评审都会建立在漂移的前提上。结论不是“先改最显眼的”，而是“先修最容易污染系统认知的”。\"\n```\n\n### Example 4: 分支比较\n\n```bash\nsthink start --name \"performance-tradeoff\" --goal \"比较缓存止血与查询优化的优先级\" --mode branch --totalSteps 5\nsthink step --sessionPath \"<session-path>\" --content \"方案 A：先引入缓存削峰。好处是见效快、对接口层侵入小，适合先止血；坏处是会把问题从“数据库慢”转成“缓存一致性与失效策略复杂”，如果根因其实是查询设计不合理，这条路容易把偶然复杂度永久留在系统里。与此同时，方案 B：直接做索引优化和查询重写。好处是从根上消除瓶颈，长期结构更干净；代价是需要更仔细验证写入放大、锁竞争和回归风险。这条路更慢，但如果业务模型稳定，通常比提前上缓存更符合简单优先的原则。\"\n```\n\n## Storage & Export Boundary\n\n- runtime 会自动保存会话状态与步骤记录\n- 完成态可生成 replay 文档\n- `replay` 支持导出到当前目录，便于审阅与复用\n\n## Heuristic Reminders\n\n以下提醒是启发式问题，不是硬约束。真正重要的是：它们能帮助你减少空转，逼近结论。\n\n- **问题定义提醒**: 你现在是在描述现象，还是在定位根因？\n- **证据提醒**: 当前判断基于事实、观察结果，还是基于猜测与假设？\n- **边界提醒**: 当前问题影响的是局部模块、单系统，还是跨系统结构？\n- **复杂度提醒**: 你是在消除本质复杂度，还是在增加偶然复杂度？\n- **收敛提醒**: 当前是否已经足够形成结论，还是仍在无效发散？\n\n## Tips\n\n- 不要再手写 thought JSON；让 CLI runtime 负责节奏、落盘与 replay\n- 不要把 sequential-thinking 当成默认模式，只在真正需要多步收敛时调用\n- 如果不确定模式，先用 `explore`\n- `step` 的 `content` 只表达当前推进内容，不要重复补全系统上下文\n- 如果发现前提错了，就明确修正，不要硬撑\n- 到收敛阶段时，应明确输出结论、风险和下一步动作\n- 只有已完成会话才能执行 `replay`","tags":["sequential","thinking","skill","skills","haaaiawd","agent-skills","claude-code","claude-skills","cli-runtime","copilot-coding-agent","cursor","multi-step-reasoning"],"capabilities":["skill","source-haaaiawd","skill-sequential-thinking-skill","topic-agent-skills","topic-claude-code","topic-claude-skills","topic-cli-runtime","topic-copilot-coding-agent","topic-cursor","topic-multi-step-reasoning","topic-reasoning","topic-sequential-thinking"],"categories":["Sequential-thinking-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/Haaaiawd/Sequential-thinking-skills/sequential-thinking-skill","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add Haaaiawd/Sequential-thinking-skills","source_repo":"https://github.com/Haaaiawd/Sequential-thinking-skills","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 6 github stars · SKILL.md body (4,381 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:41.447Z","embedding":null,"createdAt":"2026-05-18T13:22:11.394Z","updatedAt":"2026-05-18T19:14:41.447Z","lastSeenAt":"2026-05-18T19:14:41.447Z","tsv":"'+1':269,283,299,303,321,327 '1':194,243 '2':200,308 '3':205,332 '4':214,401 '5':169,220,257,347,415 '6':224 '7':228 '8':171 'add':130 'adr':362,373 'agent':111 'ai':17,145 'analysi':341 'audit':166,178 'b':434 'bash':120,245,310,334,403 'boundari':445 'branch':165,176,413 'capabl':48 'chang':339 'change-impact-analysi':338 'cli':22,113,119,127,135,140,150,204,483 'content':181,261,278,295,314,351,370,389,419,499 'contract':141 'core':47 'design':376 'diagnosi':251 'exampl':233,242,307,331,400 'explor':164,174,255,345,496 'export':444 'g':123,131 'goal':158,211,252,342,410 'heurist':454 'impact':340 'instal':105,122 'json':148,235,481 'mission':27 'mode':159,162,212,254,344,412 'model':107 'n':268,282,298,302,320,326 'name':157,210,248,337,406 'npm':115,121,203 'perform':408 'performance-tradeoff':407 'philosophi':85 'pnpm':129 'profil':316 'queri':250 'query-diagnosi':249 'recommend':191 'remind':455 'replay':154,185,187,231,449,451,487,509 'runtim':106,183,446,484 'sequenti':2,9,125,133,197,490 'sequential-think':1,196,489 'sequential-thinking-c':124,132 'sessionpath':260,277,294,313,350,369,388,418 'skill':12,24,29,109,143,237 'skill-sequential-thinking-skill' 'source-haaaiawd' 'sql':265 'start':152,155,208,247,336,405 'step':153,179,217,259,276,293,312,349,368,387,417,497 'sthink':138,207,216,230,246,258,275,292,311,335,348,367,386,404,416 'storag':443 'system':375 'text':193 'think':3,10,126,134,198,491 'thought':15,147,480 'tip':478 'topic-agent-skills' 'topic-claude-code' 'topic-claude-skills' 'topic-cli-runtime' 'topic-copilot-coding-agent' 'topic-cursor' 'topic-multi-step-reasoning' 'topic-reasoning' 'topic-sequential-thinking' 'totalstep':160,167,213,256,346,414 'tradeoff':409 'use':65 'work':84 'workflow':192 '上下文保持':58 '不会想':42 '不再要求':144 '不是硬约束':457 '不能把':102 '不要再手写':479 '不要带着错误前提继续推进':93 '不要把':488 '不要把现象描述误当作根因定位':88 '不要硬撑':504 '不要重复补全系统上下文':501 '不该把它们当成同一种改动处理':353 '不适用场景':78 '不重复整套背景':100 '与此同时':432 '主因是列表页批量加载时触发的':297 '主路径动作完成':151 '也就是说':325 '也避免一上来引入缓存复杂度':306 '交付思考方式与调用约束':112 '仅允许':163,168 '仍然存在':328 '从查询日志看':279 '代价是需要更仔细验证写入放大':438 '以下提醒是启发式问题':456 '以下示例不是为了让你回去手写':234 '以及如何避免把顺序思考退化成松散输出':26 '优先级应该后移':330 '优先识别主矛盾':96 '优化顺序应该先消除':301 '会自动保存会话状态与步骤记录':447 '但如果业务模型稳定':441 '但它不是第一性瓶颈':329 '但文档里没写清楚':384 '但还不能直接下结论':285 '作为命令入口':139 '你是在消除本质复杂度':473 '你现在是在描述现象':462 '使用':137 '便于审阅与复用':453 '信号':284 '修正前提':309 '允许修正':20,89,222 '允许先比较再收敛':57 '允许回看并修正前面的判断':54 '先不要急着选优化手段':262 '先修最容易污染系统认知的':399 '先做影响矩阵':371 '先判断问题是否真的需要':195 '先处理那些会改变系统边界或调用语义的项':391 '先安装或确认本地已有':202 '先引入缓存削峰':422 '先找主问题':86 '先拆开看':354 '先改最显眼的':397 '先消除复杂度':94 '先澄清问题':34 '先用':495 '其余上下文应由':182 '再堆解决方案':95 '再处理数值与体验层面的项':392 '再形成方法':70 '再找答案':87 '再补索引验证尾延迟':304 '再讨论平衡性':394 '分发':116 '分支比较':55,402 '初始范围或方法不明确':68 '到收敛阶段时':225,505 '前面想错了':91 '前面的判断需要修正':318 '动态修正':52 '单步即可完成的任务':80 '单系统':470 '只在真正需要多步收敛时调用':493 '只接受':180 '只接受四个输入':156 '只是执行载体':23 '只有在任务明显是在审查既有判断时才用':177 '只有在任务明显是在比较候选路径时才用':175 '只有已完成会话才能执行':508 '只表达当前推进内容':500 '可以收敛了':390 '可修正':32 '可复核的推理过程':33 '可导出的推理轨迹':77 '可额外导出到当前目录':190 '后面会把':360 '后面的缓存':272 '否则后续所有实现和评审都会建立在漂移的前提上':395 '和':374 '回看':315 '因为它会悄悄破坏调用方的假设':380 '因为重复查询也可能只是症状':286 '因此总步数上调一档':291 '在以下场景调用':66 '在使用前':117 '在复杂度上升时比较替代路径':37 '在复杂问题里':18 '在多步推理中维持清晰的问题边界与目标':59 '在推进过程中允许修正和调整判断':36 '在有限步数内收敛成结论与建议':39 '坏处是会把问题从':426 '基础推演':244 '复杂变更拆解':333 '复杂度提醒':472 '多写几段':14 '太早下结论':45 '太难复核':46 '好处是从根上消除瓶颈':436 '好处是见效快':423 '如何修正':240 '如何推进':239 '如何收敛':241 '如果不先分型':359 '如果不确定模式':494 '如果你不确定该选哪种模式':172 '如果发现前提错了':502 '如果根因其实是查询设计不合理':430 '如需要':189,201 '它们能帮助你减少空转':459 '它解决的不是':41 '安装后':136 '完成后按需使用':229 '完成态可生成':448 '定位查询性能下降的主因':253 '对接口层侵入小':424 '导致每次关联查询都在放大全表扫描成本':324 '就回头修':92 '就明确修正':503 '已经出现明显的':281 '并最终收敛成结论':21 '应先确保本地已安装对应':118 '应明确输出结论':506 '当作默认出口':104 '当出现新证据时':221 '当前判断基于事实':465 '当前是否已经足够形成结论':476 '当前步只表达当前判断':99 '当前问题影响的是局部模块':469 '当复杂问题需要系统性逐步推理时使用':4 '当存在替代路径时':56 '当成默认模式':492 '当新证据出现时':53 '必须输出结论':226 '想得太散':44 '我还能继续想':103 '或':128,170 '或初始范围不明确且需要受控收敛的任务':8 '手写':146 '执行层通过':149 '把复杂问题拆成连续步骤':50 '拆解复杂变更的影响与优先级':343 '持续推进':19 '接口级':267 '接口语义变化最危险':379 '支持导出到当前目录':452 '收敛提醒':475 '数值平衡会影响规则表':377 '数据库慢':427 '文档':188,450 '方案':420,433 '无需多步推演的问题':82 '是单条':264 '最后保留可回放的推理轨迹':40 '最终必须形成判断':61 '最终必须落到结论':101 '有的是接口语义变化':357 '有的是数值平衡':356 '有的是机制原则调整':355 '有边界':31 '本':142 '本身':322 '本身负责定义什么时候该进入这种思考方式':25 '机制原则类改动通常会回流到':372 '某条关键查询本身很慢':290 '查询次数过多':288 '次因是关联字段缺少索引放大了单次查询成本':300 '每一步只写当前推进内容':219 '每一步只推进一步':98 '比较缓存止血与查询优化的优先级':411 '混成一锅':366 '生成与导出回放文档':232 '用':206,215 '用于读取已完成会话并生成':186 '用户一次性提出了多项规则修改':352 '用户详情接口在一次请求里触发了大量重复读取':280 '用来把复杂问题处理成一个':30 '的':363,498 '的核心不是':13 '的隐性契约':385 '直接做索引优化和查询重写':435 '真正拖垮接口的不是':319 '真正有价值的地方':238 '真正重要的是':458 '简单事实查询':79 '索引':273 '约束':161 '纯头脑风暴且暂时不要求收敛的场景':83 '结果后':317 '结论不是':396 '结论可以收敛了':296 '结论收束':60 '给出':209 '缓存一致性与失效策略复杂':429 '而不是单线硬推':38 '而不是急着给答案':35 '而不是抢着给补丁':97 '而不是无限发散':62,72 '而不是硬撑前提':90 '而不是硬撑旧判断':223 '而不是试图一口气得到完整答案':51 '而不是默认套用':199 '而是':43,398 '而是为了说明这种':236 '而是关联列缺少索引':323 '而是有没有改到':382 '而是让':16 '自动恢复并注入':184 '若根因没分清':271 '落盘与':486 '被多个模块默认依赖':383 '观察结果':466 '让':482 '设计规划':6 '证据不足与隐含假设':75 '证据提醒':464 '识别漏洞':74 '该改':361 '该改设计文档的':364 '该补代码契约的':365 '负责节奏':485 '路径已经非常明确':81 '转成':428 '边界提醒':468 '还是':289 '还是仍在无效发散':477 '还是在增加偶然复杂度':474 '还是在定位根因':463 '还是基于猜测与假设':467 '还是更上层的调用放大':270 '还是跨系统结构':471 '还有的是文档与实现脱节':358 '这个':11,28,108 '这条路容易把偶然复杂度永久留在系统里':431 '这条路更慢':440 '这样既先打掉主矛盾':305 '这里最该警惕的不是改动数量':381 '迭代推进':49 '退化':266 '适合先止血':425 '适用于多阶段分析':5 '逐步推进':218 '通常比提前上缓存更符合简单优先的原则':442 '通过':114 '逼近结论':460 '配置与测试基线':378 '重写都可能只是补丁':274 '锁竞争和回归风险':439 '长期结构更干净':437 '问题分解':7 '问题定义提醒':461 '问题需要多个相互关联的推理步骤':67 '需要先把问题拆成几层':263 '需要先拆问题':69 '需要回看已有判断':73 '需要在有限候选方案之间做比较':71 '需要留下可回放':76 '需要继续确认慢点究竟来自':287 '面向':110 '顺序上应优先修正文档与契约':393 '风险与下一步建议':227 '风险和下一步动作':507 '默认用':173","prices":[{"id":"92813ffa-6a8d-408a-a5f9-536e9f14bd91","listingId":"75b19b55-1c9b-44e9-9b47-8d46a60fc90c","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"Haaaiawd","category":"Sequential-thinking-skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:22:11.394Z"}],"sources":[{"listingId":"75b19b55-1c9b-44e9-9b47-8d46a60fc90c","source":"github","sourceId":"Haaaiawd/Sequential-thinking-skills/sequential-thinking-skill","sourceUrl":"https://github.com/Haaaiawd/Sequential-thinking-skills/tree/master/skills/sequential-thinking-skill","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:11.394Z","lastSeenAt":"2026-05-18T19:14:41.447Z"}],"details":{"listingId":"75b19b55-1c9b-44e9-9b47-8d46a60fc90c","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"Haaaiawd","slug":"sequential-thinking-skill","github":{"repo":"Haaaiawd/Sequential-thinking-skills","stars":6,"topics":["agent-skills","claude-code","claude-skills","cli-runtime","copilot-coding-agent","cursor","multi-step-reasoning","reasoning","sequential-thinking"],"license":"mit","html_url":"https://github.com/Haaaiawd/Sequential-thinking-skills","pushed_at":"2026-04-05T09:34:28Z","description":"Sequential thinking for AI agents: a reusable skill and CLI runtime for stepwise reasoning, revision, replay, and convergence — no extra MCP server required.","skill_md_sha":"24f6116b373399ec7ace439f0cc82c2678e79f1d","skill_md_path":"skills/sequential-thinking-skill/SKILL.md","default_branch":"master","skill_tree_url":"https://github.com/Haaaiawd/Sequential-thinking-skills/tree/master/skills/sequential-thinking-skill"},"layout":"multi","source":"github","category":"Sequential-thinking-skills","frontmatter":{"name":"sequential-thinking","license":"MIT","description":"当复杂问题需要系统性逐步推理时使用。适用于多阶段分析、设计规划、问题分解，或初始范围不明确且需要受控收敛的任务。"},"skills_sh_url":"https://skills.sh/Haaaiawd/Sequential-thinking-skills/sequential-thinking-skill"},"updatedAt":"2026-05-18T19:14:41.447Z"}}