ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Implementation: [Feature Name]

Implementation: [Feature Name] Implementation: [Feature Name]【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skillsSpecSpecificationSummary[Quick description]TasksTask 1Task 2Task 3TimelineStart: [Date] Target completion: [Date]Status[Update as work progresses]虽然只有五个章节但每个字段在 notion-spec-to-implementation 技能中都有明确的语义与最佳实践支撑。下面逐一展开 ### 2.1 标题# Implementation: [Feature Name] 标题采用统一的命名模式 Implementation: 功能名与 Standard 模板的 # Implementation Plan: [Feature Name] 相区分。统一的命名约定参见 [task-creation.md](https://link.gitcode.com/i/56940518a6d02a0b746fcc86fe2fba00) 中对命名约定的强调有利于在 Notion 搜索中快速定位同类计划页——后续无论是人工还是通过 Notion:notion-search 检索都能一眼识别这是一份实施计划而非规格或任务页。 ### 2.2 Spec以 Notion mention 建立双向链接 markdown ## Spec mention-page url...Specification/mention-pagemention-page url...是 Notion 的页面提及mention标记在创建计划页时应替换为规格页的真实 URL。这一行是整个模板的「溯源锚点」它让计划页与原始规格形成单向引用任何查看计划的人都能一键跳回规格原文技能工作流第 4 步「Link artifacts」进一步要求计划链接规格、任务同时链接计划与规格并在规格页补充一个简短的 Implementation 章节指回计划与任务参见 SKILL.md从而形成双向可导航的工件网络在 api-feature.md 的完整示例中可以看到规格页被更新、追加## Implementation段落并嵌入计划 mention 的具体做法。2.3 Summary一句话说清做什么## Summary [Quick description]用一两句话说明本次改动的目标。虽然只有一行但它承接了规格解析的结果——在进入计划阶段之前技能要求先用 spec-parsing.md 从规格中提取功能需求、验收标准、约束与优先级见 SKILL.md。Summary 就是把这些解析结论浓缩成的一句话概述供团队在不打开规格页的情况下快速理解计划意图。2.4 Tasks可勾选的任务清单## Tasks - [ ] mention-page url...Task 1/mention-page - [ ] mention-page url...Task 2/mention-page - [ ] mention-page url...Task 3/mention-page这是 Quick 模板中最具执行力的部分与技能中任务管理的规范深度绑定任务粒度每个任务建议控制在 12 天可完成、有单一明确交付物、可独立验证、依赖最小参见 task-creation.md。超过 3 天或多个交付物的任务应继续拆分小于 2 小时的任务则应与相关工作合并任务命名使用动作动词开头Implement / Build / Create / Fix / Test / Document 等并带上具体上下文例如Implement: User login flow参见 task-creation.md任务页面虽然 Quick 模板把任务以 checkbox 形式内联在计划页中但技能仍建议在任务数据库中创建独立任务页以承载 Context、Objective、Acceptance Criteria、Dependencies、Resources 等结构化信息模板见 task-creation-template.md。内联 checkbox 适合快速概览独立任务页适合真正执行与状态流转。2.5 Timeline起止日期双锚点## Timeline Start: [Date] Target completion: [Date]Quick 模板的时间线刻意保持极简只记录开始日期与目标完成日期两个锚点不引入阶段里程碑表格。这与 Standard 模板形成对照——后者要求以 Markdown 表格列出每个 Phase 的 Milestone、Target Date 与 Status参见 standard-implementation-plan.md。小型改动通常只有一两个自然阶段过度拆解里程碑反而增加维护负担。2.6 Status持续维护的进度字段## Status [Update as work progresses]这是 Quick 模板中唯一要求「随工作进展持续更新」的字段。技能为其配套了完整的进度维护规范progress-tracking.md更新频率每日更新任务状态变化、进度备注、阻塞项、里程碑更新阶段完成、重大交付物就绪、状态变更更新To Do → In Progress → In Review → Done以及任何状态进入 Blocked更新方式通过Notion:notion-update-page更新计划页与任务页的状态属性并在正文追加进度说明。任务状态的流转可参考 progress-tracking.md 中定义的五种状态语义简单化原则Quick 计划不需要 Standard 模板中 0%100% 的总体进度百分比与分阶段状态表参见 standard-implementation-plan.md一段如实更新的文字即可。但进度更新应遵循 progress-tracking.md 的最佳实践及时、具体、量化、立即记录阻塞、以实施计划页作为唯一事实来源source of truth。三、模板在技能工作流中的位置Quick Implementation Plan 模板并不是孤立的文档它处于 SKILL.md 定义的端到端工作流之中。完整流程如下步骤动作对应工具/文档0若 Notion MCP 未连接先配置并登录codex mcp add notion --url https://mcp.notion.com/mcp、codex mcp login notion、启用rmcp_client1定位并读取规格Notion:notion-search→Notion:notion-fetch→ 参考 spec-parsing.md2选择计划深度简单改动用 Quick 模板多阶段用 Standard 模板3创建任务Notion:notion-search定位任务数据库 →Notion:notion-create-pages创建任务4链接工件计划↔规格、任务↔计划规格、规格页补充 Implementation 章节5跟踪进度progress-tracking.md 定义的节奏与模板其中第 2 步是 Quick 模板的入口当 Agent 判断规格对应的改动为简单变更时就应使用本模板作为Notion:notion-create-pages的 content 骨架创建计划页参见 SKILL.md。从源码结构看reference 目录将quick-implementation-plan.md与standard-implementation-plan.md并列存放正是为了让 Agent 在计划深度决策时能同时看到两种模板并快速取舍。四、实战从规格到 Quick 计划的一键落地结合 api-feature.md 展示的调用模式一个典型的小型功能落地过程如下第 1 步定位规格。通过Notion:notion-search以[Feature Name] spec为关键词搜索规格页若有多个命中则询问用户选择未找到则向用户索取 URL/ID参见 spec-parsing.md。第 2 步读取并解析规格。用Notion:notion-fetch拉取页面全文识别需求、验收标准、约束与优先级将歧义记录为 Clarifications 块参见 SKILL.md。第 3 步创建 Quick 计划页。使用Notion:notion-create-pages在parent中指定计划所在页面并将填充后的 Quick 模板作为页面 contentNotion:notion-create-pages parent: { page_id: engineering-plans-parent-id } pages: [{ properties: { title: Implementation: User Profile Avatar Fix }, content: [使用 Quick Implementation Plan 模板填充的计划内容] }]计划页创建后将mention-page url...占位符替换为规格页的真实 URL使计划与规格建立引用关系。第 4 步创建并链接任务。先Notion:notion-search定位任务数据库再Notion:notion-fetch确认数据库 schema记录data_source_id形如collection://tasks-db-uuid随后用Notion:notion-create-pages在数据库中创建任务页并通过 relation 属性同时链接规格页与计划页参数结构参见 task-creation.mdNotion:notion-create-pages parent: { type: data_source_id, data_source_id: collection://tasks-db-uuid } properties: { [Title Property]: Fix: Avatar upload validation error, Status: To Do, Priority: High, [Project/Related]: [spec-page-id, plan-page-id], Assignee: [Person] (if known), date:Due Date:start: [Date] (if applicable) } content: [使用 task-creation-template.md 模板填充的任务描述]【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表