Skip to content

docs(marketing): prepare WeChat article for NeoCode project introduction #548

@Cai-Tang-www

Description

@Cai-Tang-www

Summary

本 Issue 负责产出 NeoCode 项目的微信推文/公众号作品介绍文章,用于 1024 实训营结营前的项目展示与最佳产品人气奖传播。文章需要清楚说明 NeoCode 解决什么问题、为什么有价值、当前 Demo 能展示什么,以及如何引导读者关注项目和 GitHub 仓库。

Background

根据第 4 次 Milestone 通知,团队需要在 5 月 6 日 23:00 前提交作品介绍文章,用于发布在 1024 实训营公众号上,并计入最佳产品人气奖的公众号点赞得分。该文章不仅是宣传材料,也会影响外部读者对项目定位、产品价值和技术亮点的理解。

当前 NeoCode 项目已经具备 AI 编程、任务拆解、架构调度、SubAgent 协作、实时进度回灌等方向的设计基础,但对外表达仍需要统一成一条清晰主线:

NeoCode 不是普通的 AI 代码生成工具,而是面向复杂软件工程任务的 AI 协作开发系统。

Problem

Current Behavior

目前项目对外介绍可能存在以下问题:

  • 项目价值表达偏技术化,外部读者不一定能快速理解 NeoCode 解决了什么真实问题;
  • 功能点较分散,缺少“用户痛点 → 解决方案 → 演示效果 → 技术亮点”的完整叙事;
  • 没有形成适合微信推文传播的版本,无法直接用于公众号发布;
  • GitHub Star、公众号点赞等传播目标没有被明确纳入文章设计。

Expected Behavior

完成一篇可直接提交给实训营公众号的微信推文稿件,要求:

  • 能让非项目成员快速理解 NeoCode 的产品定位;
  • 能讲清楚 AI 编程工具在复杂工程任务中的痛点;
  • 能突出 NeoCode 在任务拆解、DAG 调度、SubAgent 协作、实时进度回灌等方面的差异化价值;
  • 能结合 Demo 截图/演示流程展示项目效果;
  • 能自然引导读者点赞、关注和 Star GitHub 仓库。

Impact

如果不完成该文章:

  • 团队无法按时提交公众号作品介绍材料;
  • 最佳产品人气奖的公众号点赞传播会受到影响;
  • 项目价值可能只停留在内部技术讨论中,外部评委和读者难以快速理解;
  • 最终路演时的产品叙事也会缺少统一表达基础。

User Scenario

一个不了解 NeoCode 的读者看到公众号文章后,应能在 1 分钟内理解:

  1. 现在 AI 写代码虽然强,但复杂工程任务仍然存在任务拆解混乱、执行过程不可见、上下文容易丢失、多文件修改难追踪等问题;
  2. NeoCode 通过任务规划、DAG 调度、SubAgent 执行、实时进度展示等机制,让 AI 编程过程变得可观察、可调度、可协作;
  3. 项目已经具备可演示的 Demo,可以展示从用户需求输入到任务拆解、执行进度、代码产出的完整流程;
  4. 读者可以通过 GitHub Star 和公众号点赞支持项目。

Goals

  • 输出一篇完整微信推文初稿。
  • 明确文章标题、副标题和一句话项目定位。
  • 说明 NeoCode 的用户痛点、解决方案和项目价值。
  • 用通俗语言介绍核心技术亮点,避免只堆技术名词。
  • 预留 Demo 截图、架构图或演示 GIF 的插入位置。
  • 在文末加入 GitHub 仓库链接、Star 引导和点赞引导。
  • 确保文章可在 5 月 6 日 23:00 前提交。

Non-Goals

本 Issue 不处理:

  • 不负责开发新的核心功能;
  • 不负责最终路演 PPT 的完整制作;
  • 不负责个人奖项申报材料;
  • 不负责公众号排版的最终视觉设计;
  • 不负责刷赞、诱导性营销或不真实宣传;
  • 不夸大尚未实现的能力,未完成能力只能写为规划或未来方向。

Proposed Design

微信推文建议采用“产品故事 + 技术亮点 + Demo 展示 + 行动引导”的结构。

推荐结构:

  1. 标题区

    • 标题:NeoCode:让 AI 编程从“生成代码”走向“协作开发”
    • 副标题:面向复杂软件工程任务的 AI 协作开发系统
  2. 开头:提出问题

    • AI 代码生成越来越强,但复杂项目开发仍然困难;
    • 传统 AI 编程工具常见问题:任务拆不清、执行不可见、上下文丢失、多文件修改难追踪。
  3. 项目定位:NeoCode 是什么

    • NeoCode 是一个面向复杂软件工程任务的 AI 协作开发系统;
    • 它关注的不只是生成一段代码,而是把开发任务变成可拆解、可调度、可观察的工程流程。
  4. 核心价值:为什么需要 NeoCode

    • 对用户:降低复杂开发任务的理解和执行成本;
    • 对团队:让 AI 执行过程可追踪、可复盘、可协作;
    • 对工程实践:让 AI 编程更接近真实软件工程流程,而不是单轮问答。
  5. 功能亮点

    • 需求理解与任务拆解;
    • DAG 任务依赖调度;
    • SubAgent 分工执行;
    • 实时进度回灌;
    • 文件修改与执行结果汇总。
  6. Demo 展示

    • 插入用户输入需求截图;
    • 插入任务拆解/DAG/执行进度截图;
    • 插入最终代码修改或结果总结截图。
  7. 技术亮点

    • 为什么用 DAG 表达任务依赖;
    • 为什么引入 SubAgent;
    • 为什么需要实时状态回灌;
    • 如何保证项目后续可维护和可扩展。
  8. 结尾:邀请支持

    • 欢迎点赞公众号文章;
    • 欢迎访问 GitHub 仓库并 Star;
    • 简短说明后续规划。

该设计优先解决“读者为什么要关心这个项目”的问题,再介绍方案和技术细节,避免文章变成单纯的功能清单。

Scope

In Scope

  • 微信推文文案初稿;
  • 文章标题、副标题和小标题;
  • 项目价值说明;
  • Demo 展示段落;
  • GitHub Star 和公众号点赞引导;
  • 图片/截图占位说明;
  • 对未实现能力的措辞边界检查。

Out of Scope

  • 实际公众号后台排版;
  • 重新制作完整 UI;
  • 新增 Demo 功能;
  • 路演 PPT 全套内容;
  • 宣传数据统计脚本。

Acceptance Criteria

  • Given 一个不了解 NeoCode 的读者阅读文章开头,when 阅读前 3 段,then 能理解项目要解决“复杂 AI 编程任务不可控、不可见、难协作”的问题。
  • Given 文章进入项目介绍部分,when 读者阅读项目定位,then 能明确 NeoCode 是“面向复杂软件工程任务的 AI 协作开发系统”,而不是普通聊天式代码生成工具。
  • Given 文章介绍功能亮点,when 出现 DAG、SubAgent、实时进度回灌等术语,then 每个术语都配有对应的通俗解释和价值说明。
  • Given 项目存在未完成能力,when 文章提到这些方向,then 必须标注为“规划中”“后续将支持”或“未来方向”,不得写成已完成能力。
  • Given 文章用于公众号发布,when 检查结尾部分,then 包含点赞引导、GitHub Star 引导和项目仓库链接占位。
  • Given 团队需要在 5 月 6 日 23:00 前提交材料,when 本 Issue 关闭,then docs/marketing/wechat-article.md 或等价文档中已有可提交的完整文章初稿。

Test Plan

  • 人工检查文章是否包含:痛点、方案、价值、功能、Demo、技术亮点、行动引导。
  • 让至少 1 名非核心开发成员阅读文章,并确认其能在 1 分钟内复述项目定位。
  • 检查文章中所有能力描述是否与当前 Demo 状态一致,避免过度承诺。
  • 检查图片占位是否明确,例如:[插入:任务拆解截图][插入:DAG 执行流程图][插入:最终结果截图]

Risks / Compatibility

  • 风险:文章过于技术化,导致普通读者看不懂。

    • 处理方式:先讲用户痛点和产品价值,再讲技术方案。
  • 风险:为了宣传效果夸大能力。

    • 处理方式:区分“已实现”“演示中”“未来规划”。
  • 风险:文章只服务人气奖,忽略最终路演。

    • 处理方式:文章主线应同时复用到路演 PPT 的产品故事部分。

Follow-ups

  • 根据本文案制作公众号排版版式;
  • 从 Demo 中截取 3–5 张关键图片;
  • 将文章主线复用到最终路演 PPT;
  • 补充 README 首页的项目定位和 Star 引导。

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationhelp wantedExtra attention is needed

Type

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions