用途
可行性研究技能(Feasibility Study Skill)用于从第一性原理出发对解决方案选项进行可行性分析。根据其触发说明,它应在编写技术规格(tech-spec)之前使用,典型场景包括:评估解决方案、比较不同方案、进行风险评估。它明确声明不适用于以下情况:已有技术规格(应使用 /deep-analyze)、需要实现而非分析(应使用 /codex-implement)、只是快速提问(应使用 /codex-explain 或 /codex-architect)。
触发关键词包括:feasibility、is this possible、can we、should we、explore options、before tech spec。
主要能力
该技能通过补充 Agent 为每个方案选项派发后台探索任务,示例代码为:
Agent({ description: "Explore feasibility of solution option", subagent_type: "feasibility-analyst", prompt: Research the feasibility of: <solution description> Evaluate technical feasibility, effort, risk, extensibility, and maintenance cost. })
使用方式(工作流)
整体流程为:Resolve → Decompose → Constraints → Code research → Solutions → Codex discussion → Decision → Report。
-
阶段 0:解析功能上下文(Resolve the feature context)。该技能可被直接调用(/feasibility-study <topic>),也可被其他技能调用。它通过运行以下命令自行解析上下文:
node scripts/resolve-feature.js [--feature <key>]
返回一个 JSON 文档,技能读取 scan_error、current_authority 以及 design_records 条目。当 scan_error !== false 时,会进入 ⚠️ Need Human 退出,不继续处理。
-
阶段 1:需求分解(Requirement Decomposition)。输入来源优先级:若从 design_records 解析到需求文档,则作为权威陈述并通过 5-Why 验证;否则通过 5-Why 分析从用户输入中提取需求。对 type: requirements 的候选做筛选,规则为:无候选则走用户输入路径;恰好一个则使用该候选;两个及以上且恰好一个 is_canonical: true 则使用该候选;两个及以上且无或多个 canonical 则进入 Need Human 关口。5 Why 用于挖掘本质:表层需求(用户要求什么)、底层问题(为什么需要)、成功标准(可量化的验收)。
-
阶段 2:约束分析(Constraint Analysis)。按类型(技术、业务、资源、兼容性)清点约束,并给出灵活性评级。
-
阶段 3:代码研究(Code Research)。研究已有代码库,包括相关模块与可复用逻辑、现有设计模式、需要绕开的技术债。
-
阶段 4:方案探索(Solution Exploration)。头脑风暴 2-3 个以上方案,每个包含:核心思路(一句话)、实现路径、量化可行性、成本与取舍。
-
阶段 5:Codex 深度讨论(In-Depth Codex Discussion)。为核心步骤,除非使用 --no-codex,否则不可省略。所用工具包括:/codex-brainstorm(在开始时枚举所有选项)、/codex-architect(在方案形成后评估设计)、@skills/codex-code-review/references/codex-transport.md § Resume(随时询问细节)。
-
阶段 6:对比决策(Comparative Decision)。进行并排比较,输出推荐方案、备选方案和开放问题。
评估维度
各维度按绿/黄/红分级:技术可行性(有现成模式 / 需要适配 / 重大创新)、工作量(<3 人日 / 3-10 人日 / >10 人日)、风险(范围小 / 有一定不确定性 / 大量未知)、可扩展性(易于扩展 / 需要重构 / 难以扩展)、维护成本(干净简单 / 有些复杂 / 复杂)。
输出
输出包含标题为“Feasibility Study: <title>”的报告,其中包括量化对比表格(列为 Criterion、Option A、Option B、Option C)以及带理由的推荐方案。
验证清单
5 Why 分解已完成;约束已清点并标注灵活性;已研究现有代码(grep/read);已探索 2-3 个以上方案并做量化评估;Codex 讨论已记录(除非 --no-codex);已有对比表 + 推荐 + 开放问题。
与其他命令的关系
/feasibility-study → /tech-spec → /deep-analyze → /codex-implement。
示例
- 输入:/feasibility-study "Add user quota management"。动作:5 Why → 约束 → 代码研究 → 3 个方案 → Codex 讨论 → 推荐。
- 输入:/feasibility-study "Optimize cache" --context src/service/cache.ts。动作:读取缓存代码 → 约束 → 方案 → Codex 头脑风暴 → 对比 → 报告。
参考资料
分析阶段:references/analysis-phases.md;Codex 讨论:references/codex-discussion-guide.md;输出模板:references/output-template.md。
限制
其主要限制在技能声明中给出:不适用于已有技术规格、需要实现而非分析、以及快速提问的场景。此外,缺少需求文档属于正常状态而非退出条件;但若扫描出现错误(scan_error !== false)则必须进入 Need Human 退出。关于收费、价格、平台等信息,资料中暂未提供。