Skip to content

feat: v1.5.0 外部同步 + pace-init 架构优化 - #1

Merged
arch-team merged 19 commits into
mainfrom
feature/v1.5.0-external-sync
Feb 26, 2026
Merged

arch-team merged 19 commits into
mainfrom
feature/v1.5.0-external-sync

Conversation

@arch-team

Copy link
Copy Markdown
Owner

Summary

  • 外部同步系统:新增 /pace-sync Skill,支持 CR 与 GitHub Issues 双向同步(adapter pattern 架构,平台无关的 procedures + GitHub adapter)
  • pace-init 架构优化:Token 优化(SKILL.md 190→62 行,procedures 拆分为 9 文件)+ 六大原则重构(checks 数据提取、Git 策略回归、CI SSOT、路由层清理)
  • Hook + Rules 集成:sync-push advisory hook、语义同步状态缓存比对、7 步管道对齐
  • 文档体系:pace-init/pace-sync 英中特性文档、README 优化、user-guide BizDevOps 映射表

Key commits (19)

Commit Description
3752242 knowledge: integrations-format + cr-format 扩展 external sync
85691f4 docs: v1.5.0 design/requirements/roadmap
5d174ba knowledge: sync-mapping-format schema
970fa25 hooks: sync-push advisory hook
951e56f skills: pace-sync Skill + sync-procedures
ecfdc1d rules: §16 sync management rules
43c2ed9 chore: v1.5.0 version bump + conftest + test fix
c73a6c2 docs: v1.5.0 feature docs + sync maintenance test
9d587d6 feat: pace-sync product optimization 16 items
23a525a refactor: pace-sync adapter pattern
4cb9e2f docs: design/feature docs align with adapter refactor
539b583 feat: pace-init 综合优化 14 项
5601da0/1087ab7 docs: pace-init feature docs (EN/ZH)
a99b51e feat: Hook + Rules + 语义同步集成
f8398de refactor: pace-init Token 优化 — procedures 拆分
054adda refactor: pace-init 六大原则架构优化
02af787 docs: pace-init 特性文档架构表补充
a5f1d45 docs: README 优化 + user-guide 补充

Test plan

  • bash scripts/validate-all.sh — 224 tests passed, 0 failed
  • markdownlint 0 errors (82 product layer files)
  • Layer separation check — no product→dev references
  • Plugin loading — 14/14 skills discovered
  • Manual: claude --plugin-dir ./ load test
  • Manual: /pace-init trigger test on sample project
  • Manual: /pace-sync setup flow verification

🤖 Generated with Claude Code

Test User and others added 19 commits February 25, 2026 20:01
…l sync

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- plugin.json/marketplace.json 1.4.1 → 1.5.0
- state-format 合法版本追加 1.5.0
- conftest 注册 pace-sync Skill + sync-mapping-format Schema
- 修复交叉引用测试误判占位符 URL 为内部链接

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- New: docs/features/pace-sync.md (EN) + pace-sync_zh.md (ZH) feature docs
- CHANGELOG.md: v1.5.0 entry (Added/Changed/Backward Compatible)
- user-guide.md + _zh: /pace-sync command section + specialized commands line
- README.md + _zh: Specialized Features table row for /pace-sync
- CONTRIBUTING.md + _zh: Skill count 14→16
- .claude/CLAUDE.md: feature docs sync authority chain
- test_sync_maintenance.py: TC-SM-04 feature docs sub-command drift detection
- dev-workflow.md §4: feature docs sync manual check item

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Wave 1 (MVP closure):
- C1: Label pre-creation in setup (prevent first-push failures)
- A1: Semantic Comment generation (replace template with context-rich comments)
- B1: /pace-sync unlink subcommand (remove CR-external association)
- B2: /pace-sync push --dry-run preview mode
- D2: §11 merged pipeline step 7 (auto-push on merge → close Issue + done label)

Wave 2 (integration deepening):
- D1: pace-status sync summary display (N synced, M pending)
- D3: pace-change Step 4 sync reminder after change operations
- B3: /pace-sync create subcommand (create Issue from CR metadata)
- B4: §4.8 Gate result sync procedures (Gate pass/fail → Comment + Label)

Wave 3 (quality & experience):
- D4: Teaching catalog sync_setup/sync_push/sync_create triggers
- D5: Pulse signal #9 "sync lag" (>24h since last sync)
- C2: API rate limit protection (1s interval + 429 retry)
- C3: Issue state/locked pre-check before push
- A2: P3 progressive automation (init auto-setup + CR auto-create + merged auto-push)

Wave 4 (architecture):
- A3: Inbound polling architecture design (CLI Plugin has no webhook)

Planning docs: Roadmap Phase 18/19/20 revised, requirements F11.9-F11.14,
design §19 inbound architecture + Appendix B updated (16 Skills → 18, 12 Schema → 13).

14 files, +331/-49 lines. 223 pytest + markdownlint + layer separation passed.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…dures + GitHub adapter

Extract platform-specific operations from sync-procedures.md into
sync-adapter-github.md, making procedures platform-agnostic (OCP).
Update SKILL.md triggers, add create/unlink to rules §16, and align
sync-mapping-format.md state descriptions to semantic labels.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…ctor

Update design.md architecture diagrams, adapter routing tables, and
extension points. Consolidate feature docs (EN/ZH) to reference
sync-procedures.md instead of duplicating step details. Add layer
separation rule §5 to CLAUDE.md.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
OPT-1~8 现有优化 + NEW-1~6 新增功能:

- OPT-1(P0): 项目生命周期感知初始化(阶段 A/B/C 自动判定 + 按阶段适配策略)
- OPT-2(P1): CLAUDE.md 智能合并(devpace-start/end 标记幂等注入)
- OPT-3(P1): checks.md 工具链精准检测(vitest/jest/mocha, ruff/flake8 等 4 技术栈)
- OPT-4(P2): --from 模式增强(目录+多文件+API 规格解析)
- OPT-5(P2): 清理 v0.1 迁移代码 + v1.5.0 迁移框架
- OPT-6(P2): full 模式分阶段引导(4 阶段可提前退出)
- OPT-7(P1): 初始化后情境化引导(按生命周期+模式输出)
- OPT-8(P2): context.md 检测阈值 3→1 + 维度扩展
- NEW-1(P1): --verify 健康检查(Schema 逐一校验 + --fix 自动修复)
- NEW-2(P2): --dry-run 预览(不写入文件)
- NEW-3(P2): --reset 重置(二次确认 + CLAUDE.md 清理 + --keep-insights)
- NEW-4(P3): --export-template / --from-template 模板管理
- NEW-5(P3): Monorepo 感知初始化
- NEW-6(P1): 初始化后自动轻量校验

3 文件重写,707 行增量(707 ins / 123 del)。
223 pytest + markdownlint + 层隔离 + plugin 加载全通过。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Comprehensive feature doc covering lifecycle-aware initialization,
all subcommands (--verify/--reset/--dry-run/--from/--export-template),
toolchain detection matrix, CLAUDE.md smart merge, usage scenarios,
architecture details, and developer reference. Follows pace-sync.md
format conventions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Chinese translation of pace-init.md feature doc, following
pace-sync_zh.md conventions. Covers lifecycle detection, all
subcommands, toolchain detection, usage scenarios, architecture,
and troubleshooting.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
sync-push.mjs: 重写为缓存比对模式(.devpace/.sync-state-cache),仅在实际
状态转换时触发提醒(消除每次写入的噪音,F11.8)。merged 转换使用指令性语言
(auto-execute),其他转换使用建议性语言。

post-cr-update.mjs: merged 管道从 4 步扩展为 7 步(对齐 §11)。第 7 步外部
同步为条件输出——仅在 sync-mapping.md 存在且 CR 有外部关联时追加。

utils.mjs: 新增 readSyncStateCache/updateSyncStateCache 缓存工具函数。

rules §16: 三处文案精炼(缓存比对说明 + 双层保障 + 协调 section)。
test_hooks.py: sync-push.mjs 注册 + TC-HK-16 async 配置验证。
feature docs: Advisory Hook → 双层保障 section(中英文)。
roadmap: M18.2/M18.3 → ✅ 完成,Phase 18 全部关闭。

224 pytest + markdownlint + 层隔离 + plugin 加载全通过。

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
将 pace-init 的 SKILL.md 从 190 行瘦身至 66 行(纯路由层),将单体
init-procedures.md(801 行)按子命令拆分为 7 个独立文件,实现渐进式
信息披露和按需加载,预计加权平均 Token 消耗降低约 55%(14,600→6,500)。

- SKILL.md: 190→66 行,参照 pace-sync 路由表模式
- init-procedures-core.md: 446 行(生命周期+最小初始化+合并+校验+迁移+质量检查+Monorepo)
- init-procedures-full.md: 164 行(环境探测+分阶段引导+发布配置)
- init-procedures-from.md: 53 行(--from 解析+--import-insights 导入)
- init-procedures-verify.md: 54 行(--verify 健康检查)
- init-procedures-dryrun.md: 40 行(--dry-run 预览)
- init-procedures-reset.md: 31 行(--reset 重置)
- init-procedures-template.md: 25 行(模板导出/应用)
- 更新 docs/features/ 中英文文档的 20 处引用
- 修复 test_template_placeholders 的 procedure 文件名匹配模式

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…OT + 路由层清理

产品层变更(Batch 1-5):
- B1: SKILL.md 版本检测 3 行实现细节 → 1 行路由描述(抽象与实现分离)
- B2: core.md §9 工具链检测 84 行纯参考数据 → 新建 init-procedures-checks.md(SRP + SSOT)
- B3: full.md CI/CD 检测表 → 引用 integrations-format.md 权威源(SSOT)
- B4: Git 策略检测从 full.md 移回 core.md,默认流程自包含(可读性)
- B5: 迁移章节增长哨兵注释(可扩展性)

core.md 446→387 行,full.md 164→154 行,新增 checks.md 84 行。
224 tests passed, markdownlint 0 errors, 分层检查通过。

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
开发层变更(Batch 6):
- 英文/中文特性文档新增 "Skill File Architecture" 章节(9 文件拆分表 + 行数统计)
- "Related Resources" 从单一 core.md 链接扩展为完整 9 文件 procedures 列表

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
README 四项改进:
- A: 新增 Full Development Lifecycle 生命周期全景图
- B: 重写 How It Works 为概念价值导向
- C: 新增 vs Alternatives 替代方案对比表
- D: 丰富 Workflow 为三段式(常规/变更/完整循环)

user-guide 新增 Methodology Mapping 章节:
- 6 阶段生命周期映射表
- 4 个反馈闭环实现表
- 3 维度量体系映射表

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@arch-team
arch-team merged commit ea268d4 into main Feb 26, 2026
3 checks passed
arch-team added a commit that referenced this pull request Mar 4, 2026
- 更新安装命令为 marketplace install 方式(EN+CN)
- 添加测试方法论链接(cross-session-test.md)
- 添加 GIF 占位符标记(EN+CN)
- 添加 Dev.to YAML frontmatter(tags, canonical_url)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
arch-team added a commit that referenced this pull request Mar 8, 2026
design.md:
- §0 价值链更新为 Opportunity→Epic→BR→PF→CR (#3)
- §0 横切 Skill 补充 /pace-next (#6)
- §3 作业对象计数 四类→五类 (#7)
- §8 project.md 价值树补充 Epic 层 (#8)
- §12 补齐 pace-next/pace-test/pace-sync/pace-biz 4 个 Skill (#1)
- §12 Agent 路由表补充 pace-change/pace-biz/pace-test (#2)
- §12 Skill 统计更新为 18+1 (#13)
- §13 模型关系索引价值链补充 Epic (#9)

.claude/CLAUDE.md:
- 开发守则价值链更新为含 Opportunity/Epic (#10)
- 权威索引编号更新 S1-S42, F1-F12, NF1-NF11 (#4)
- 删除 dev-principles.md 幽灵引用 (#11)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant