菜单
任务难度评估节流阀——对用户输入的任务/需求进行多维度难度分析和评分，防止低估复杂度。先追溯任务涉及的上下文（代码结构、依赖关系、影响范围），再综合评分并给出分级和执行建议。内置"上浮偏差"：除非任务明显简单，否则主动提升一个难度等级。独立使用时做纯难度评估，结合其他工具时可作为任务执行的前置判断。 务必在以下场景使用本 skill：难度分析、任务评估、复杂度评分、difficulty analysis、task scoring、节流阀、任务分级、风险评估、影响范围分析、工作量评估、scope analysis、前置判断。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | task-difficulty |
| description | 任务难度评估节流阀——对用户输入的任务/需求进行多维度难度分析和评分，防止低估复杂度。先追溯任务涉及的上下文（代码结构、依赖关系、影响范围），再综合评分并给出分级和执行建议。内置"上浮偏差"：除非任务明显简单，否则主动提升一个难度等级。独立使用时做纯难度评估，结合其他工具时可作为任务执行的前置判断。 务必在以下场景使用本 skill：难度分析、任务评估、复杂度评分、difficulty analysis、task scoring、节流阀、任务分级、风险评估、影响范围分析、工作量评估、scope analysis、前置判断。 |
本 Skill 解决一个核心问题：AI 模型容易低估任务复杂度。用户给出一句话需求，模型可能直接动手，忽略隐藏的技术债、跨模块耦合、边界条件，导致返工或质量问题。
本 Skill 作为节流阀（throttle valve）：在执行前先评估难度，给出分级和上下文分析，防止"看起来简单实则复杂"的任务被草率处理。
graph LR
INPUT["用户输入<br/>任务描述"]
CLASS["输入分类提示<br/>Pinpoint/Bounded/<br>Complex/Grand"]
CTX["上下文追溯<br/>涉及的文件·模块·依赖"]
SCORE["多维度评分<br/>5个维度 × 1-5分"]
LEVEL["难度分级<br/>L1-L5"]
THROTTLE{"节流阀<br/>是否明显简单？"}
OUT_KEEP["维持原级"]
OUT_BUMP["上浮一级"]
RESULT["输出<br/>难度报告"]
INPUT --> CLASS --> CTX --> SCORE --> LEVEL --> THROTTLE
THROTTLE -->|"是，L1证据充分"| OUT_KEEP --> RESULT
THROTTLE -->|"否，存在不确定性"| OUT_BUMP --> RESULT
style INPUT fill:#e3f2fd,stroke:#1976d2
style CLASS fill:#ede7f6,stroke:#4527a0,color:#311b92
style THROTTLE fill:#fff3e0,stroke:#f57c00,stroke-width:2px
style RESULT fill:#e8f5e9,stroke:#388e3c
被 orchestrator 调用时，接收输入分类结果作为评分校准参考（不替代评分）：
| 输入分类 | 分数预期范围 | 说明 |
|---|---|---|
| Pinpoint | L1-L2 (1-4) | 分类提示为低难度区间，但评分仍可能突破（如目标点涉及复杂依赖链） |
| Bounded | L2-L3 (2-6) | 分类提示为中低区间 |
| Complex | L3-L4 (4-8) | 分类提示为中高区间 |
| Grand | L4-L5 (7-10) | 分类提示为高难度区间 |
如果实际评分与分类提示的预期范围偏差 > 2 级，须在难度报告中标注偏差原因。
| 等级 | 名称 | 典型特征 | 示例 |
|---|---|---|---|
| L1 | 琐碎 | 单文件、无逻辑变更、配置/文案修改 | 修改按钮文字、更新版本号 |
| L2 | 简单 | 单模块、逻辑清晰、无跨模块影响 | 新增一个工具函数、修复已定位的 Bug |
| L3 | 中等 | 多文件、涉及 2-3 个模块、需要设计决策 | 新增 CRUD 页面、重构组件 API |
| L4 | 复杂 | 跨模块联动、架构影响、需要方案评审 | 新增权限系统、接入第三方支付 |
| L5 | 重大 | 系统级变更、破坏性改动、数据迁移 | 微服务拆分、数据库 Schema 迁移、框架升级 |
这是本 skill 的核心差异化机制——加权分偏置，而非直接跳级：
对每个维度打 1-10 分，然后取加权平均映射到 L1-L5。
| 维度 | 权重 | 评估内容 |
|---|---|---|
| 范围 (Scope) | 30% | 涉及多少文件/模块、变更面积 |
| 深度 (Depth) | 25% | 技术复杂度、算法难度、架构层级 |
| 耦合 (Coupling) | 20% | 跨模块依赖、接口变更的连锁影响 |
| 风险 (Risk) | 15% | 出错的代价、可逆性、数据安全 |
| 认知 (Cognition) | 10% | 需要的领域知识、隐含的业务规则 |
| 加权分范围 | 等级 |
|---|---|
| 1.0 - 2.0 | L1（琐碎） |
| 2.1 - 4.0 | L2（简单） |
| 4.1 - 6.0 | L3（中等） |
| 6.1 - 8.0 | L4（复杂） |
| 8.1 - 10.0 | L5（重大） |
完整评分细则见 →
references/scoring-guide.md
评分不是凭空打分，必须先追溯任务涉及的上下文：
1. 解析输入 → 提取关键实体（模块名、文件名、功能点、技术概念）
2. 探索代码 → 查找相关文件、导入链、依赖关系
3. 识别边界 → 确定变更的直接影响范围和间接影响范围
4. 发现隐患 → 检查测试覆盖、类型安全、错误处理等
注意：本 skill 独立工作时，自行读取项目文件获取上下文。
一段任务描述文本。可以是：
# 难度评估报告
## 基本信息
- **任务**: {一句话描述}
- **原始评级**: L{n}
- **最终评级**: L{m} {上浮说明或保持原因}
## 评分明细
| 维度 | 分数(1-5) | 依据 |
|------|----------|------|
| 范围 | {n} | {简要说明} |
| 深度 | {n} | {简要说明} |
| 耦合 | {n} | {简要说明} |
| 风险 | {n} | {简要说明} |
| 认知 | {n} | {简要说明} |
| **加权** | **{avg}** | |
## 上下文分析
### 涉及范围
- 直接影响：{文件/模块列表}
- 间接影响：{可能受连锁影响的部分}
### 关键风险点
- {风险1}
- {风险2}
## 执行建议
{根据难度等级给出的执行策略建议}
python scripts/difficulty_scorer.py assess --input <任务描述文本> [--root <project_root>] [--format json|markdown]
--root：提供项目路径时，会自动追溯代码上下文辅助评分--format：默认 markdown，json 格式便于程序消费脚本实现见 →
scripts/difficulty_scorer.py
基础设施技能——维护项目 docs/ 目录的模块化组织和进度追踪。由编排器在 Plan 末尾和 Deliver 阶段强制调用，禁止跳过。模块文档按业务维度分目录存放详细内容，进度记录按日期/会话hash存放摘要。支持多人协作和跨会话任务追溯，文件头部标识 Git 账号。 务必在以下场景使用本 skill：创建文档、文档目录管理、docs 目录、产出物管理、输出文档、document output、docs management、模块文档、文档分类、多人协作文档、跨会话文档、进度记录、任务摘要、progress、会话记录、开发日志。
Infrastructure skill — maintains modular organization and progress tracking for the project docs/ directory. Mandatory invocation by orchestrator at end of Plan and during Deliver stages; must not be skipped. Module documents are organized by business dimension in subdirectories with detailed content; progress records are stored as summaries by date/session hash. Supports multi-person collaboration and cross-session task tracing with Git account identification in file headers. Use this skill when: creating documents, document directory management, docs directory, deliverable management, output documentation, document output, docs management, module documentation, document classification, multi-person collaborative documentation, cross-session documentation, progress records, task summaries, progress, session records, development logs.
Full-lifecycle flow orchestrator for project development. Upon receiving user input, it first classifies the input (4 tiers), then adaptively senses project context, scores task difficulty, selects the optimal route, and orchestrates the Plan→Execute→Validate→Deliver four-phase pipeline with quality gates and failure reflow. Use this skill when: the user wants to start a new project, receives a new requirement, needs a full development iteration, wants to go through the complete flow from requirements to delivery, or says things like "start building", "launch the project", "how to implement this requirement", "help me plan this", "do it end-to-end". When the user's intent is to complete an end-to-end development task (rather than just one step), use this skill to orchestrate the entire flow. If the user only needs a specific step (e.g., just write requirement docs), use the corresponding specialized skill directly.
Infrastructure skill — maintains project file tree snapshots and code structure summaries in a SQLite database (.cache/context.db) at the project root, solving the problem of models forgetting project structure across sessions. Mandatory invocation by orchestrator during context awareness stage (before route selection) and Deliver stage; must not be skipped. Scans all project files (source, config, docs, tests, assets), never modifies files. Use this skill when: understanding overall project structure, querying a module's file list and exported symbols, restoring project structure understanding across sessions, project awareness, context sync, project memory, code summary indexing, viewing project structure. This skill does not modify source code or manage document outputs.
项目开发全生命周期的流程编排器。接收用户输入后，先做输入分类（4 档），自适应感知项目上下文、评估任务难度、选择最优路径，编排 Plan→Execute→Validate→Deliver 四阶段并管理质量卡点和失败回流。 务必在以下场景使用本 skill：用户要开始一个新项目、接到一个新需求、要做一次完整的开发迭代、要从需求到交付走一遍完整流程，或者用户说"开始做"、"启动项目"、"这个需求怎么落地"、"帮我规划一下"、"从头到尾做一遍"。 当用户的意图是完成一个端到端的开发任务（而不是只做其中某一步），使用本 skill 来编排整个流程。如果用户只需要其中某一步（如只写需求文档），直接使用对应的专项 skill。
基础设施技能——在项目根目录 .cache/context.db（SQLite）中维护项目文件树快照与代码结构摘要，解决模型跨会话遗忘项目结构的问题。由编排器在上下文感知阶段和 Deliver 阶段强制调用，禁止跳过。扫描项目中所有文件（源码、配置、文档、测试、资源），不修改任何文件。 务必在以下场景使用本 skill：需要了解项目全局结构、查询某模块的文件列表和导出符号、跨会话恢复项目结构理解、项目感知、context sync、项目记忆、project memory、代码摘要索引、查看项目结构。本 skill 不修改源码，不管理文档产出。