Clarifications Needed【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills[Requirement ID/Description]Current text: [Ambiguous requirement]Question: [What needs clarification]Impact: [Why this matters for implementation]Assumed for now: [Working assumption if any]**关键信息缺失**时记录缺失块 markdown ## Missing Information - **[Topic]**: Spec doesnt specify [whats missing] - **Impact**: Blocks [affected tasks] - **Action**: Need to [how to resolve]需求互相冲突时记录冲突块## Conflicting Requirements **Conflict**: REQ-1 says [X] but REQ-5 says [Y] **Impact**: [Implementation impact] **Resolution needed**: [Decision needed]处理原则创建澄清任务或在规范上加评论绝不带着歧义盲目开工。验收标准解析显式标准直接取自 Acceptance Criteria 章节逐条转为 checklist- [ ]隐式标准从需求推导例如Users can upload files up to 100MB可推出≤100MB 上传成功、100MB 被拒并报错、上传过程有进度指示、上传可取消可测试性校验System is fast不可测试应写成Page loads in 2 secondsUsers like the interface不可测试应写成90% of test users complete task successfully。技术细节、依赖、范围与风险技术细节抽取系统组件、数据模型、API/接口、集成点、技术选型记录设计决策及其 trade-off 与理由依赖识别外部依赖第三方服务、外部 API、基础设施、工具/库、内部依赖前置功能、共享组件、团队依赖、时间线依赖硬性截止日期、里程碑依赖、排序要求范围提取明确 In Scope要构建的功能、要支持的使用场景、服务的用户、Out of Scope延后的功能、不支持的场景、未处理的边界情况与假设环境、用户、系统状态风险识别技术风险未经证实的方案、复杂集成、性能顾虑、扩展性未知、业务风险市场时机、资源可用性、对外依赖并记录规范中提到的缓解策略。规范质量评估与解析清单好规范的特征需求清晰、有显式验收标准、定义了优先级、识别了风险、勾勒了技术方案不完整的规范则相反需要记录缺口并创建澄清任务。创建实施计划前的解析检查清单包括全部功能需求已识别、非功能需求已记录、验收标准已提取、依赖已识别、风险已记录、歧义已文档化、技术方案已理解、范围清晰、优先级已定义。第 3 步选择计划深度并创建计划根据改动规模选择模板reference/quick-implementation-plan.md 与 reference/standard-implementation-plan.md简单改动 / 小变更→ 快速计划模板多阶段功能 / 迁移→ 标准计划模板。快速计划模板# Implementation: [Feature Name] ## Spec mention-page url...Specification/mention-page ## Summary [Quick description] ## Tasks - [ ] mention-page url...Task 1/mention-page - [ ] mention-page url...Task 2/mention-page - [ ] mention-page url...Task 3/mention-page ## Timeline Start: [Date] Target completion: [Date] ## Status [Update as work progresses]标准计划模板标准模板覆盖了完整要素Overview1-2 句功能描述与业务价值、Linked Specification、Requirements Summary功能需求 / 非功能需求 / 验收标准、Technical Approach架构、技术栈、关键设计决策、Implementation Phases每个阶段含 Goal / Tasks / Deliverables / Estimated effort、Dependencies外部 / 内部 / Blockers、Risks MitigationProbability / Impact / Mitigation、Timeline 里程碑表、Success Criteria技术成功 / 业务成功、Resources 与 Progress TrackingPhase Status、Overall Progress、Latest Update。两个模板都要求链接回原始规范且计划页通过Notion:notion-create-pages创建内容包括overview、关联的 spec、需求摘要、阶段划分、依赖/风险、成功标准。可选做法是同时用Notion:notion-update-page在规范页末尾追加一个简短的 Implementation 小节指向计划与任务。第 4 步创建任务定位任务数据库创建任务前先定位任务数据库reference/task-creation.md1. Search for task database: Notion:notion-search query: Tasks or Task Management or [Project] Tasks 2. Fetch database schema: Notion:notion-fetch id: database-id-from-search 3. Identify data source: - Look for data-source urlcollection://... tags - Extract collection ID for parent parameter 4. Note schema: - Required properties - Property types and options - Relation properties for linking关键点schema 中的collection://abc-123-def将作为创建任务的parent数据源标识。任务粒度与创建模式合理任务规模1-2 天可完成、单一清晰交付物、可独立测试、依赖最少超过 3 天或多交付物需要继续拆分少于 2 小时则过细应与相关工作合并。粒度随阶段变化早期阶段任务可偏大如Design database schema中期适中如Implement user authentication后期小而精确如Fix validation bug in form。每个工作项按六步创建识别工作 → 确定任务规模 → 在数据库创建任务 → 设置属性 → 撰写任务描述 → 链接到 spec/plan。调用示例Use Notion:notion-create-pages: parent: { type: data_source_id, data_source_id: collection://tasks-db-uuid } properties: { [Title Property]: Task: [Clear task name], Status: To Do, Priority: [High/Medium/Low], [Project/Related]: [spec-page-id, plan-page-id], Assignee: [Person] (if known), date:Due Date:start: [Date] (if applicable), date:Due Date:is_datetime: 0 } content: [Task description using template]任务描述模板reference/task-creation-template.md 给出了精简版Context关联 spec 与 plan、Description、Acceptance Criteriachecklist、Technical Details、DependenciesBlocked by / Blocks、Resources、Progress。而 reference/task-creation.md 中的完整版任务描述则进一步包含Objective、Requirements对应规范需求、Technical Approach含 Components Affected、Key Decisions、Estimated Effort。任务类型与命名按动词开头规范命名语义一目了然类型命名模式示例基建/搭建Setup: ...Setup: Configure database connection pool功能实现Implement: ...Implement: User login flow集成Integrate: ...Integrate: Add payment provider测试Test: ...Test: E2E testing for checkout flow文档Document: ...Document: API endpoints修 BugFix: ...Fix: Memory leak in image processing重构Refactor: ...Refactor: Extract auth logic to service命名要具体Implement user login with email/password 优于 Add login、带上下文Dashboard: Add revenue chart widget 优于 Add chart。排序、优先级与估算关键路径Database schema → API foundation → Core business logic → Frontend integration → Testing → Deployment并行轨道后端API 端点 / 业务逻辑 / 数据库操作、前端UI 组件 / 状态管理 / 路由、基础设施CI/CD / 监控 / 文档可并行推进优先级P0/Critical阻塞一切、核心功能、安全、数据完整性→ P1/High重要功能、用户可见、性能→ P2/Medium可选功能、优化→ P3/Low未来增强、边界情况、外观估算故事点 1/2/3/5/8 分别对应几小时/半天/一天/两天/3-4 天≥8 点应拆分时间估算 2-4 小时为小任务、1 天为中等、2 天为大任务、3 天继续拆分。任务关系与批量创建父任务模式大功能用Feature: User Authentication作为父任务下设 Setup/Implement/Test 子任务依赖链模式Design schema → Implement data models → Create API endpoints → Integrate with frontend逐级阻塞关联任务模式中央任务Feature: Dashboard关联后端 API、前端组件、数据缓存等并行任务批量创建逐工作项确定属性 → 创建任务页 → 链接 spec/plan → 设置关系随后更新计划中的任务链接、复核排序、分配负责人。验证清单最终确认每个任务有清晰目标、验收标准可测试、依赖已识别、规模 1-2 天、优先级已分配、已链接 spec/plan、排序正确、资源已注明。第 5 步链接产物规范 ↔ 计划 ↔ 任务计划链接到规范任务同时链接到计划和规范可选用Notion:notion-update-page在规范页追加简短的 Implementation 小节指向计划与任务。这样形成双向导航从任何一页都能跳到其余相关页面评审与追踪时不必来回翻找。第 6 步追踪进度reference/progress-tracking.md 定义了完整的进度追踪体系。更新节奏每日更新活跃实施期任务状态变更、给任务加进度说明、更新阻塞项时机为工作结束、完成重要工作、遇到阻塞时里程碑更新阶段完成时在计划中标记阶段完成、添加里程碑总结、必要时更新时间线、向干系人汇报状态变更更新任务状态迁移时To Do → In Progress开工、In Progress → In Review待评审、In Review → Done完成、Any → Blocked阻塞每次迁移更新状态属性并附迁移说明。进度说明模板每日进度说明## Progress: [Date] ### Completed - [Specific accomplishment with details] ### In Progress - [Current work item] - Current status: [Percentage or description] ### Next Steps 1. [Next planned action] ### Blockers - [Blocker description] or None ### Decisions Made - [Any technical/product decisions] ### Notes [Additional context, learnings, issues encountered]reference/progress-update-template.md 提供简化版Completed Today / In Progress / Next Steps / Blockers / Notes适合高频快速更新。里程碑总结reference/milestone-summary-template.mdAccomplishments / Deliverables / Metrics / Learnings / Next Phase完整版还含 Overview、Completed Tasks勾选 mention、Key Accomplishments、Challenges Overcome、Impact on Timeline、Next Phase。计划页状态同步用进度指示器保持计划页为单一事实源## Status Overview **Overall Progress**: 45% complete ### Phase Status - ✅ Phase 1: Foundation - Complete - Phase 2: Core Features - In Progress (60%) - ⏳ Phase 3: Integration - Not Started ### Task Summary - ✅ Completed: 12 tasks - In Progress: 5 tasks - Blocked: 1 task - ⏳ Not Started: 8 tasks **Last Updated**: [Date]【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考