Communitygithub.com

usibuilds/feature-builder

以“自上而下规划,自下而上构建”的方式开发软件或自动化——先制定简短的 PLAN.md 规范,再在每个对话中完成一个经过测试的功能,最后以 FEATURE COMPLETE 通知和交接信息结束。适用于用户规划项目、请求下一个功能或逐步构建应用、网站或工作流时。

feature-builder 是什么?

该技能采用“自上而下规划,自下而上构建”的方法论,将项目开发分解为两个清晰的模式:首先在 Mode A 中创建或更新 PLAN.md 计划文件,涵盖产品定位、技术栈、核心实体、功能清单和验收标准;然后在 Mode B 中逐个构建功能,每个功能都附有验收测试和分步实现指导。构建完成后输出 FEATURE COMPLETE 通知,并生成包含目标、决策、状态、文件列表和下一步步骤的交接块,方便在下一个对话中无缝继续。该技能适用于任何支持 PLAN.md 文件的聊天应用或编码工具(如 Claude Code、Cursor 等),能有效避免长对话历史导致的上下文丢失问题,通过维护一个 2-5K token 的计划文件来保持项目结构和进度可见性。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/usibuilds/claude-context-zones/tree/main/skills/feature-builder

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Feature Builder — 自上而下规划,自下而上构建

请用用户的语言回复。代码、命令、文件名以及 PLAN/HANDOFF 块保持英文。

理念: 建筑师先绘制整个房子的蓝图(自上而下),然后施工人员逐层铺设经过测试的砖块(自下而上)。计划保持简短并存储在文件中,这样每个新对话只需读取一个 2-5K token 的计划,而非 100K token 的聊天历史。

模式 A — 自上而下:创建或更新计划

当尚无计划,或用户要求规划时:

  1. 最多提出 3 个问题(目标、用户、必备功能),除非答案已经明确。
  2. 编写一个 PLAN.md 块(最多约 120 行):
    • 产品一句话描述
    • 技术栈(固定)
    • 核心数据/实体(要点式,无代码)
    • 功能清单(按构建顺序,带复选框):- [ ] **F1 名称** — 一行范围描述
    • 验收规则(“完成”的定义)
    • 决策日志
    • 后期想法(我们当前不会构建的内容)
  3. 告诉用户将其保存为项目知识中的 PLAN.md(聊天应用)或仓库中的 docs/PLAN.md(编码工具)。

模式 B — 自下而上:构建一个功能

当用户说“构建 F3”或“下一个功能”时:

  1. 仅处理该功能,只读取所需的内容。
  2. 首先提供迷你计划:要创建或更改的文件/节点,以及验收测试(3-6 条 QA 风格的检查:输入 → 预期结果)。等待用户确认。
  3. 分小步构建。每步之后,提供要运行的确切测试或要点击的内容。
  4. 任何属于其他功能的内容 → 添加到“后期想法”中;此时不构建。

当所有验收测试通过时 — 功能完成

请完全照此输出通知:

✅ FEATURE COMPLETE: <F-编号 + 名称>
Tests passed: <列表>
PLAN.md update: mark <F-编号> as [x]
Next feature: <下一个未选中的 F-编号 + 名称>
→ Copy the handoff below → new chat → paste → "next feature"

然后提供交接块:目标、决策、状态、文件、未解决的 BUG、下一步的 3 个步骤。

如果测试失败或用户尚未测试

不要输出 FEATURE COMPLETE。修复,重新测试,然后再输出。

相关技能