SuperAPI AI 工具集

project-structure

智能体与模型

查看项目

更新于 10-15 21:47

技能介绍

用途:按用户既定的、与语言无关的仓库规范搭建或整理项目结构,仅应用当前工作所需的角色与文档,保留项目已有有效约定,重大结构调整前先说明。语言与栈相关命令、配置由对应语言技能负责。

主要能力与布局:根目录放置面向用户的 README.md、manifest、单一权威 lockfile、智能体上下文、可选贡献规则与治理文件;源码设一个约定源根,按领域或命名空间组织;单元测试与源码同置,端到端测试置于顶层项目自有位置,仅为已交付或易回归层增加分层测试;docs/ 容纳架构、快速开始、工具链、代码风格与部署;一次性自动化放 scripts/、bin/ 或 tools/;生成产物设一个被忽略的位置;可选生成器模板、静态资源与预置智能体技能。

治理:根目录保留 VISION.md(长期产品与技术方向,含排除项)、DEFINITION_OF_READY.md(实现前的硬性门槛)、DEFINITION_OF_DONE.md(可交付前的硬性门槛)。多区域仓库中以最近的区域文件为准;治理、智能体、贡献者与项目文档之间用链接关联而非重复策略;工作流需要但缺失治理文件时应指出,不得自行编造替代。

智能体上下文:AGENTS.md 为权威,CLAUDE.md 为其符号链接,或在无法链接时仅含 include 加真正的 Claude 专属补充,不得维护分叉副本。根 AGENTS.md 保持轻量,聚焦非显而易见的坑、确切命令、硬约束与安全边界。仅在规则不同处新增 <area>/AGENTS.md。人类合并要求以 CONTRIBUTING.md 为权威并链接引用。若预置技能,.agents/skills/ 与 skills-lock.json 由技能工具生成,不可手改,并将 .claude/skills 链接至 .agents/skills。

使用与限制:创建或重构 README、docs、治理与智能体文件或多区域仓库时参阅 references/documentation.md;安装钩子、脚本、变更日志生成、markdown/链接/重复检查或架构漂移约束时参阅 references/tooling.md。完成标准为仓库声明的验证门槛通过、受改动影响的文档为最新且仅存一处权威版本、生成文件经由其所属工具修改、未引入无关的结构迁移。官方文本暂未提供。