diff --git a/.gitignore b/.gitignore index dc607a2..d18b5d3 100644 --- a/.gitignore +++ b/.gitignore @@ -401,7 +401,7 @@ cython_debug/ # Custom temp .agents +.opencode .worktrees !src/**/* -docs/superpowers tests/**/__tmp* diff --git a/AGENTS.md b/AGENTS.md index b77bf72..4b8c914 100644 --- a/AGENTS.md +++ b/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字段所述的规范 diff --git a/openspec/config.yaml b/openspec/config.yaml new file mode 100644 index 0000000..7c09107 --- /dev/null +++ b/openspec/config.yaml @@ -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/ 下对应文档