企业官网建设流程全解析

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 doesn't specify [what's 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 seconds"；"Users 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]

标准计划模板

标准模板覆盖了完整要素：Overview（1-2 句功能描述与业务价值）、Linked Specification、Requirements Summary（功能需求 / 非功能需求 / 验收标准）、Technical Approach（架构、技术栈、关键设计决策）、Implementation Phases（每个阶段含 Goal / Tasks / Deliverables / Estimated effort）、Dependencies（外部 / 内部 / Blockers）、Risks & Mitigation（Probability / Impact / Mitigation）、Timeline 里程碑表、Success Criteria（技术成功 / 业务成功）、Resources 与 Progress Tracking（Phase Status、Overall Progress、Latest Update）。

两个模板都要求链接回原始规范，且计划页通过Notion:notion-create-pages创建，内容包括：overview、关联的 spec、需求摘要、阶段划分、依赖/风险、成功标准。可选做法是同时用Notion:notion-update-page在规范页末尾追加一个简短的 "Implementation" 小节，指向计划与任务。

第 4 步：创建任务

定位任务数据库

创建任务前先定位任务数据库（reference/task-creation.md）：

1. 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 url="collection://..."> 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 Criteria（checklist）、Technical Details、Dependencies（Blocked by / Blocks）、Resources、Progress。而 reference/task-creation.md 中的完整版任务描述则进一步包含：Objective、Requirements（对应规范需求）、Technical Approach（含 Components Affected、Key Decisions）、Estimated Effort。

任务类型与命名

按动词开头规范命名，语义一目了然：

命名要具体（"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.md）：Accomplishments / 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