chore: 迁移项目规范至 openspec,精简 AGENTS.md 为入口指引
This commit is contained in:
2
.gitignore
vendored
2
.gitignore
vendored
@@ -401,7 +401,7 @@ cython_debug/
|
||||
# Custom
|
||||
temp
|
||||
.agents
|
||||
.opencode
|
||||
.worktrees
|
||||
!src/**/*
|
||||
docs/superpowers
|
||||
tests/**/__tmp*
|
||||
|
||||
27
AGENTS.md
27
AGENTS.md
@@ -1,26 +1 @@
|
||||
## 项目概览
|
||||
|
||||
- 本项目为 Rune(基于 SDD 规范开发辅助工具),Bun 是唯一包管理器和运行时,严禁使用 npm、pnpm、yarn、npx、pnpx
|
||||
- README.md 记录用户使用方法,DEVELOPMENT.md 记录开发技术细节
|
||||
- 使用中文(注释、文档、交流),面向中文开发者
|
||||
- 本项目无需考虑向前兼容性
|
||||
- temp目录下是手动测试使用的临时文件夹,不需要参与扫描和设计决策
|
||||
|
||||
## 全局红线
|
||||
|
||||
- 新增逻辑必须编写完善的测试,不允许跳过任何测试
|
||||
- 新增代码优先复用已有组件、工具、依赖库,不轻易引入新依赖
|
||||
- 新增代码必须更新对应的文档,保持文档内容和代码逻辑同步
|
||||
|
||||
## Git 规范
|
||||
|
||||
- 提交信息中文,格式"类型: 简短描述",类型:feat/fix/refactor/docs/style/test/chore
|
||||
- 禁止创建 git 操作 task
|
||||
|
||||
## 工作方式
|
||||
|
||||
- 积极使用 subagent 并行独立子任务,节省上下文空间;能并行的步骤明确并行
|
||||
- 单个文件或目录只分配给一个 subagent,不重复分配;subagent 输出文件路径、行号和问题摘要,不输出大段源码
|
||||
- 主 agent 负责最终结论:去重、交叉验证、合并同根因问题
|
||||
- 优先使用提问工具对用户确认
|
||||
- 禁止提交docs/superpowers目录和目录下的设计文档,不需要留存
|
||||
严格遵循openspec/config.yaml文件中context字段所述的规范
|
||||
|
||||
36
openspec/config.yaml
Normal file
36
openspec/config.yaml
Normal file
@@ -0,0 +1,36 @@
|
||||
schema: spec-driven
|
||||
|
||||
context: |
|
||||
## 项目概览
|
||||
- 本项目为 Bun 全栈应用(Alfred·阿福),Bun 是唯一包管理器和运行时,严禁使用 npm、pnpm、yarn、npx、pnpx
|
||||
- docs/user/ 记录用户使用方法,docs/development/ 记录开发技术细节
|
||||
- 使用中文(注释、文档、交流),面向中文开发者
|
||||
- 本项目无需考虑向前兼容性
|
||||
|
||||
## 文档入口(按顺序阅读)
|
||||
- **优先阅读 docs/README.md** 获取文档路由、归属矩阵和影响分析规则
|
||||
- **其次阅读 docs/development/README.md** 获取完整开发规范、常用命令和质量门禁
|
||||
|
||||
## 全局红线
|
||||
- 前端禁止导入 src/server/ 的后端运行时实现
|
||||
- 后端运行时代码禁止直接使用 console.*,通过 Logger 实例输出
|
||||
- 新增逻辑必须编写完善的测试,不允许跳过任何测试
|
||||
- 每次代码变更必须执行文档影响分析(详见 docs/README.md)
|
||||
- 新增代码优先复用已有组件、工具、依赖库,不轻易引入新依赖
|
||||
|
||||
## Git 规范
|
||||
- 提交信息中文,格式"类型: 简短描述",类型:feat/fix/refactor/docs/style/test/chore
|
||||
- 禁止创建 git 操作 task
|
||||
|
||||
## 工作方式
|
||||
- 积极使用 subagent 并行独立子任务,节省上下文空间;能并行的步骤明确并行
|
||||
- subagent 仅用于只读收集和分析,禁止用于文件修改、代码生成、git 操作或依赖安装
|
||||
- 单个文件或目录只分配给一个 subagent,不重复分配;subagent 输出文件路径、行号和问题摘要,不输出大段源码
|
||||
- 主 agent 负责最终结论:去重、交叉验证、合并同根因问题
|
||||
- 优先使用提问工具对用户确认
|
||||
|
||||
rules:
|
||||
tasks:
|
||||
- 如果是代码存在更新必须
|
||||
- 执行完整的测试、代码检查、格式检查等质量保障手段
|
||||
- 执行文档影响分析,更新 README.md 和/或 docs/ 下对应文档
|
||||
Reference in New Issue
Block a user