Skip to content

按功能受众明确对外文档与网站同步要求 #62

Description

@vilicvane

在 worktree-development 技能中,区分面向 Code3D 用户、通过 API/CLI 使用 Code3D 的 agent 的功能更新,以及其他内部更新。前者须同步合适的对外文档和网站。

已确定方案:按实际对外能力与行为判断,覆盖 GUI 操作、公开 API/CLI、agent 输入输出、使用方式和限制;在同一需求的开发 worktree 内同步相关公开指南、参考、示例及官网内容。内部实现、测试和仓库协作流程按影响更新开发文档,不机械修改对外介绍。按实际受影响的入口选择文档,不要求每次修改所有 README 或首页;复用官网既有源码和图片生成流程。主 agent 开发时识别并完成文档同步,交付 subagent 提交前复核遗漏并在回报中说明更新位置、验证及无需变更的理由。

本次仅修改工作流技能及交付参考,关联此前的 subagent 交付工作流 #53;不修改产品功能或发布网站。由 audience-docs-root-0908 在独立 linked worktree 实现。

实现完成:分支 issue-62-audience-docs-root-0908 的 worktree-development/SKILL.md 新增“功能受众与文档同步”,按产品使用者与内部改动分类,列出官网用户/agent 指南、API 参考、包说明和受影响官网入口;要求同一需求内同步,并按官网既有流程维护示例与图片。提交步骤与 delivery-subagent.md 已接入文档复核、遗漏补齐和回报要求,区分源码同步与线上发布。本次本身属于内部开发工作流调整,对外产品功能和使用约定没有变化,因此只修改两份技能文档。

验证:技能 quick_validate、两文件 Prettier、8 个相对链接及锚点、git diff --check 全部通过。未修改应用或协调脚本,不新增或重跑无关产品测试。当前改动未提交合并,等待验收。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requeststatus:reviewAwaiting acceptance, integration, or authorized push

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions