Menu
遍历项目结构变化并同步更新文档。监控模块变化、配置更新，生成检查清单以确保 SKILL、文档、示例和架构信息的实时一致性。关键词：项目结构、模块映射、文档同步、变更追踪、完整性检查。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
在发布commit前执行检查清单，包括gitignore验证、改动总结、ChangeLog更新与标准格式commit。关键词：commit前检查、gitignore、ChangeLog、commit格式、版本管理。
当需要让外部项目正确接入 Sirius Pulse 时使用，覆盖 Python API 调用、CLI 调用、配置组织和安全实践。关键词：外部接入、库调用、CLI 集成、provider 配置。
使用此技能在发布新版本到 PyPI 时执行完整的发布流程。涵盖版本更新、构建验证、tag 推送和 GitHub Actions 自动化。关键词：PyPI 发布、版本控制、自动化构建、Trusted Publishing。
在为 Sirius Pulse 做发布准备时使用，用于校验版本信息、命令可运行性、文档准确性与技能同步状态。关键词：发布准备、发布前检查、文档同步、命令校验。
编写新测试文件或为现有模块补充测试时使用，覆盖命名约定、速度要求、Mock 模式与断言规范。关键词：测试编写、单元测试、pytest、MockProvider、测试速度、精准测试。
当修改 Sirius Pulse 代码后，强制同步代码与文档、SKILL、示例的一致性。涵盖架构变更、接口变更、配置变更的全量检查清单与项目结构地图。关键词：代码同步、文档联动、变更追踪、检查清单、项目结构。
| name | project-structure-sync |
| description | 遍历项目结构变化并同步更新文档。监控模块变化、配置更新，生成检查清单以确保 SKILL、文档、示例和架构信息的实时一致性。关键词：项目结构、模块映射、文档同步、变更追踪、完整性检查。 |
在修改代码（特别是新增/删除模块或改变特性）时，通过系统化的方式遍历项目结构，识别影响范围，并生成清单以确保所有相关 SKILL、文档、示例和配置保持一致。
sirius_pulse/
├── api/ - 对外 API facade（engine/models/providers/session 等）
├── core/ - 编排核心（emotional_engine.py、prompt_factory.py、model_router.py、engine_persistence.py、identity_resolver.py）
├── async_engine/ - 兼容导出 + prompts/orchestration/utils 辅助层
├── embedding/ - Embedding 微服务（server.py aiohttp 服务端 + client.py 同步客户端）
├── persona_generation/ - 人格资产生成子包（templates.py 数据模型 + builders.py LLM 生成）
├── workspace/ - WorkspaceLayout / Runtime / Watcher / RoleplayManager
├── config/ - SessionConfig / WorkspaceConfig / JSONC / ConfigManager
├── models/ - Message / Participant / Transcript 等数据契约
├── memory/ - basic/diary/glossary/user/semantic 子包；context_assembler.py 将短期记忆以 XML 嵌入 system prompt，返回 [system, user] 两条消息；日记条目支持时间戳显示
├── session/ - SessionStore / runner
├── providers/ - Provider 实现、路由（全链路异步 httpx）
├── token/ - token 记录、SQLite 持久化与分析
├── skills/ - SKILL 注册、执行与 data store；被动 SKILL 支持；表情包子系统 sticker/
├── platforms/ - NapCat 多实例管理、QQ 桥接器、EngineRuntime 封装
├── webui/ - WebUI REST API + 静态页面
├── utils/ - 工具函数、WorkspaceLayout 路径布局
├── config/ - SessionConfig / WorkspaceConfig / ConfigManager / JSONC
└── cli.py - 库内薄 CLI
| 文件 | 用途 | 监控变化 |
|---|---|---|
pyproject.toml | 项目元数据、依赖、入口 | 版本、依赖、命令名称 |
.github/workflows/ci.yml | CI/CD 流程 | Python 版本、测试命令 |
Makefile | 开发便利命令 | 命令定义 |
scripts/ | 设置/工具脚本 | 新增脚本 |
| 文件 | 内容 | 同步触发 |
|---|---|---|
docs/architecture.md | 架构设计详解 | 模块重构、新增模块、接口变化 |
docs/full-architecture-flow.md | 完整架构流程图 | 数据流、执行流变化 |
docs/memory-system.md | 四层记忆底座 | 记忆系统变更 |
docs/engine-emotional.md | Emotional Engine 详细说明 | 引擎行为变更 |
docs/external-usage.md | 外部接入指南 | Provider 变化、API 变化、配置变化 |
docs/best-practices.md | 最佳实践与模式 | 性能优化、内存管理特性新增 |
docs/configuration.md | 配置项详解 | 配置选项新增、参数变化 |
docs/quickstart.md | 快速启动指南 | 命令名称、基本用法变化 |
README.md | 项目总览 | 用法、特性、依赖版本 |
docs/migration-v0.28.md | v0.28 Emotional Engine 迁移指南 | 引擎切换、记忆系统变更 |
docs/migration-roleplay-v0.20.md | 外部人格生成迁移指南 | roleplay_prompting 对外用法变化 |
| SKILL | 内容 | 同步触发 |
|---|---|---|
framework-quickstart | 架构快速理解、模块导读 | 新增/删除模块、模块位置变化、依赖关系变化 |
external-integration | 外部接入指南、API 用法 | Provider 变化、配置变化、API 变化 |
skill-sync-enforcer | 代码变更检查清单 | 所有满足触发条件的变更 |
commit-preparation | Commit 前检查 | ChangeLog 格式、版本信息变化 |
release-checklist | 发布前检查 | 版本信息、文档同步状态 |
执行以下检查以确定变更范围：
# 查看最近的代码变更
git log --oneline -n 5
# 查看改动文件列表
git diff HEAD~1 --name-only
# 查看具体改动统计
git diff HEAD~1 --stat
触发条件：
sirius_pulse/<module_name>/ 目录及 .py 文件必须更新：
docs/architecture.md - 新增模块说明docs/full-architecture-flow.md - 更新数据流/执行流.github/skills/framework-quickstart/SKILL.md - 更新阅读顺序和模块描述.github/skills/external-integration/SKILL.md - 若涉及外部接入tests/test_*.py 文件示例提示：
检测到新增模块: sirius_pulse/cache/
请更新：
1. docs/architecture.md - 在心智模型中添加 cache/ 说明
2. .github/skills/framework-quickstart/SKILL.md - 在阅读顺序添加对应模块
3. 新增 tests/test_cache.py
触发条件：
sirius_pulse/api/ 中的公开接口EmotionalGroupChatEngine 的公开方法签名sirius-pulse）必须更新：
docs/external-usage.md - 使用示例.github/skills/external-integration/SKILL.md - API 说明README.md - 快速开始示例examples/*.py 或 examples/*.json - 实际示例代码示例提示：
检测到 API 变更: EmotionalGroupChatEngine.process_message() 签名变化
请更新：
1. docs/external-usage.md - 更新方法说明和示例
2. examples/ - 修改使用示例
3. README.md - 更新快速开始代码
触发条件：
sirius_pulse/models/models.py 的消息 / transcript 契约变化sirius_pulse/config/models.py 的 session / workspace / orchestration 契约变化必须更新：
docs/architecture.md - 对应部分的详解.github/skills/framework-quickstart/SKILL.md - 心智模型部分示例提示：
检测到数据契约变化: SessionConfig / WorkspaceConfig / Transcript 新增字段
请更新：
1. docs/architecture.md - 更新模型说明
2. docs/external-usage.md - 若外部调用契约受影响则补充说明
3. 对应 tests 文件 - 补充测试覆盖
触发条件：
pyproject.toml 的版本/依赖变化config/manager.py 的配置选项变化.pre-commit-config.yaml 的工具版本变化必须更新：
docs/configuration.md - 新增配置选项说明README.md - 依赖版本、安装步骤examples/session.json - 配置示例示例提示：
检测到依赖变更: 新增 redis>=4.0
请更新：
1. README.md - 依赖安装说明
2. docs/configuration.md - Redis 配置选项
触发条件：
.github/workflows/ 的 CI/CD 流程变化Makefile 的命令变化scripts/ 下的工具脚本变化必须更新：
README.md - 开发指南部分sirius_pulse/<module>/ 下创建__init__.py 导出公开接口tests/test_<module>.py 单元测试docs/architecture.md 已补充模块说明和设计初衷docs/full-architecture-flow.md 已更新数据流/执行流framework-quickstart SKILL 已更新阅读顺序和模块描述external-integration SKILL 已更新（若涉及外部接入）python main.py --help 执行正常sirius_pulse/api/ 中的导出已同步更新examples/ 中的示例已测试并更新docs/external-usage.md 已补充新用法说明tests/ 的相关测试已更新README.md 的快速开始已验证CHANGELOG.md 记录pyproject.toml 已正确更新[project.optional-dependencies] 中声明docs/configuration.md 已补充新配置项说明examples/session.json 已示例新配置（若适用）README.md 的安装步骤已验证# 1. 查看最近 5 次提交的变更范围
git log --oneline -n 5
git show HEAD --stat
# 2. 列出本地未推送的提交
git log origin/master..HEAD --oneline
# 3. 查看特定契约文件的历史变更
git log -p --follow sirius_pulse/config/models.py | head -100
git log -p --follow sirius_pulse/models/models.py | head -100
# 4. 对比文档和代码的一致性
# 查看 framework-quickstart SKILL 中提到的模块是否存在
grep -o "sirius_pulse/[a-z_/]*\.py" .github/skills/framework-quickstart/SKILL.md | sort -u
# 5. 验证所有 SKILL 文件的 frontmatter 格式
grep -r "^name:" .github/skills/*/SKILL.md
grep -r "^description:" .github/skills/*/SKILL.md
变更：创建 sirius_pulse/performance/{metrics,profiler,benchmarks}.py
检查清单：
✓ 在 docs/architecture.md 的"心智模型"中补充性能监控特性说明
✓ 在 docs/full-architecture-flow.md 中补充性能指标的收集流程
✓ 在 framework-quickstart SKILL 的"阅读顺序"中添加新模块
✓ 在 external-integration SKILL 中补充使用示例
✓ 新增 tests/test_performance.py 包含 19+ 个测试
✓ tests/test_*.py 中的所有相关测试通过
✓ python main.py --help 可正常执行
变更：在 sirius_pulse/config/models.py 中新增 SessionConfig 或 WorkspaceConfig 字段
检查清单：
✓ 字段包含完整类型注解和文档字符串
✓ 在 config/models.py 中补充字段说明
✓ 在 docs/architecture.md 中更新对应数据模型描述
✓ 在 docs/external-usage.md 中补充使用示例
✓ 更新 examples/session.json 示例配置
✓ tests/test_config_manager.py 或相关测试中有相应覆盖
✓ 旧代码的兼容性已确认（提供默认值或迁移逻辑）
变更：实现 sirius_pulse/providers/new_platform.py
检查清单：
✓ 新 Provider 继承 AsyncLLMProvider 或 LLMProvider
✓ 在 sirius_pulse/providers/__init__.py 中导出
✓ 在 sirius_pulse/providers/routing.py 中注册路由
✓ 在 docs/external-usage.md 中补充接入说明
✓ 在 examples/ 中提供配置示例
✓ 在 framework-quickstart SKILL 中更新 providers 部分说明
✓ 新增 tests/test_providers_new_platform.py
docs/ > SKILL > README.md > examples/。feat: <description> / fix: <description>docs: 同步 <具体同步内容>docs: 同步 framework-quickstart 和 external-integration SKILL当完成文档/SKILL 同步后，在 PR 或提交说明中检查：
docs/ 文件README.md 和 examples/（若需要）name: 和 description: 完整）