liuyun 377bf86076 docs: 统一规范管理,去重三支柱/工作流/spec 约定
- CLAUDE.md 精简为入口:保留铁律+约定,移除内联重复,新增文档地图
- openspec-superpowers-bridge/SKILL.md 成为工作流五步唯一权威源
- docs/architecture.md 移除重复的阶段映射表,改为引用 bridge

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-10-13 13:46:58 +08:00

2.2 KiB
Raw Blame History

投云长护系统 (touyun-elderly-care)

面向老年人的养老服务与管理平台。需求与规格权威见 docs/requirements/(产品方案 + PRD)。

技术栈

待定(占位,后续在 PRD 中明确)

铁律(必须遵守,违反即返工)

  1. 需求文档(PRD)是约束/规范的唯一权威,原型仅作视觉参考;PRD 内部冲突以全局规范为准。
  2. 数据库 schema 是字段一致性的唯一锚点:data-model spec(字段字典)先行,前后端引用同一字段名,禁止各自命名。
  3. 前端先行 + Mock:前端对 Mock 验收,后端对 api-contract 契约实现。
  4. 字段/接口变更先改 shared/,再改对应 spec。

开发工作流

本项目用三支柱协作:openspec 管「要做什么」、superpowers 管「怎么一步步做对」、 harness 管「环境怎么配合」。任何功能/变更请求都按此推进。

  • 怎么走流程(分类 → 开 change → 计划 → 应用 → 归档,含 openspec↔superpowers 映射):权威见 .claude/skills/openspec-superpowers-bridge/SKILL.md。
  • 三支柱架构与分工:见 docs/architecture.md。
  • spec 组织/粒度/编号/四段式结构:见 docs/spec-conventions.md。

约定

  • 提交信息遵循 Conventional Commits(feat/fix/chore/docs/refactor)。
  • 不直接手改 openspec/ 下由 CLI 生成的文件,优先用 openspec CLI。

文档地图

文档 内容
docs/spec-conventions.md spec 组织/粒度/编号/四段式结构(唯一权威)
docs/architecture.md 三支柱架构图(职责/协作/技术分层/变更生命周期)
.claude/skills/openspec-superpowers-bridge/SKILL.md 工作流五步 + openspec↔superpowers 映射(唯一权威)
docs/requirements/ 产品方案 + PRD + 原型
docs/superpowers/plans/ / specs/ 实施计划 / 设计文档

当前进度