Menu
在发布commit前执行检查清单，包括gitignore验证、改动总结、ChangeLog更新与标准格式commit。关键词：commit前检查、gitignore、ChangeLog、commit格式、版本管理。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
当需要让外部项目正确接入 Sirius Pulse 时使用，覆盖 Python API 调用、CLI 调用、配置组织和安全实践。关键词：外部接入、库调用、CLI 集成、provider 配置。
遍历项目结构变化并同步更新文档。监控模块变化、配置更新，生成检查清单以确保 SKILL、文档、示例和架构信息的实时一致性。关键词：项目结构、模块映射、文档同步、变更追踪、完整性检查。
使用此技能在发布新版本到 PyPI 时执行完整的发布流程。涵盖版本更新、构建验证、tag 推送和 GitHub Actions 自动化。关键词：PyPI 发布、版本控制、自动化构建、Trusted Publishing。
在为 Sirius Pulse 做发布准备时使用，用于校验版本信息、命令可运行性、文档准确性与技能同步状态。关键词：发布准备、发布前检查、文档同步、命令校验。
编写新测试文件或为现有模块补充测试时使用，覆盖命名约定、速度要求、Mock 模式与断言规范。关键词：测试编写、单元测试、pytest、MockProvider、测试速度、精准测试。
当修改 Sirius Pulse 代码后，强制同步代码与文档、SKILL、示例的一致性。涵盖架构变更、接口变更、配置变更的全量检查清单与项目结构地图。关键词：代码同步、文档联动、变更追踪、检查清单、项目结构。
| name | commit-preparation |
| description | 在发布commit前执行检查清单，包括gitignore验证、改动总结、ChangeLog更新与标准格式commit。关键词：commit前检查、gitignore、ChangeLog、commit格式、版本管理。 |
在提交代码到仓库前，确保代码质量、文档完整性、隐私安全与提交规范。
验证 .gitignore 包含以下必要项：
__pycache__/, *.pyc, *.pyo, *.egg-info, build/, dist/, wheels/.venv, venv/, env/.last_config_path（用户配置缓存），API快捷配置文件.pytest_cache/, .coveragedata/（本地测试数据与会话记录）.vscode/, .idea/, *.swp, *.swo.env, .env.local（若使用环境变量管理密钥）操作指南：
# 查看当前gitignore规则
cat .gitignore
# 验证待提交文件不包含敏感内容（如API密钥）
git status --short
git diff --cached --name-only
检查清单：
git diff --cached 确认）列出此次提交涉及的改动范围：
# 查看与上次发布的差异（假设上一个tag为 v0.1.0）
git log --oneline v0.1.0..HEAD
# 或查看暂存区的改动
git diff --cached --stat
改动摘要应包含：
示例摘要：
- feat: 实现日记索引模块（memory/diary/indexer.py、memory/diary/retriever.py）
- feat: 新增智能遗忘引擎与衰退调度
- test: 添加8个记忆质量系统测试（79/79通过）
- docs: 更新architecture.md中的Phase 2记忆系统说明
- chore: 增强.gitignore覆盖范围
编辑 CHANGELOG.md，按以下格式新增条目：
格式 (Keep a Changelog 规范)：
## [Unreleased]
### Added
- 新增功能描述
### Changed
- 修改功能描述
### Fixed
- 修复问题描述
### Deprecated
- 弃用功能描述（可选）
---
## [0.1.0] - 2026-04-05
### Added
- 初始版本发布：多人角色扮演编排引擎
- 支持OpenAI兼容接口与SiliconFlow适配
- 动态群聊模式与记忆管理系统
操作指南：
# 编辑CHANGELOG.md
# 1. 将待发版本从[Unreleased]改为[版本号] - [日期]
# 2. 新增[Unreleased]占位符供下次更新
# 示例：发布v0.2.0
# [Unreleased]
# （空占位符）
#
# [0.2.0] - 2026-04-05
# ### Added
# - ...
检查清单：
使用 Conventional Commits 规范：
<type>(<scope>): <subject>
<body>
<footer>
Type 列表：
feat: 新功能fix: 问题修复refactor: 代码重构（无功能变化）test: 测试相关docs: 文档更新chore: 依赖、构建、工具等杂项perf: 性能优化Scope (可选,但推荐)：
memory, provider, cli, testsSubject：
Body (可选，但对重要改动必需)：
Footer (可选)：
Closes #123BREAKING CHANGE: 详细说明提交示例：
# 新增功能类提交
git commit -m "feat(memory): 实现记忆质量评估与智能遗忘引擎
新增sirius_pulse/memory/diary/indexer.py模块，包含：
- DiaryIndexer：关键词 + EmbeddingClient 向量索引
- DiaryRetriever：按 token 预算检索相关日记
新增sirius_pulse/memory/diary/retriever.py，提供检索工具：
- retrieve: 按查询检索适配 prompt 的日记列表
- search: 关键词/向量混合搜索
整合到DiaryManager：add()、search()、retrieve()
Closes #234"
# 修复问题类提交
git commit -m "fix(provider): 修复SiliconFlow API响应超时处理
之前在网络波动时未正确捕获超时异常，导致会话中断。
现在使用exponential backoff重试机制，重试次数配置为3次。"
# 文档更新提交
git commit -m "docs(architecture): 补充Phase 2记忆质量系统说明
新增记忆质量评估与智能遗忘章节，包含：
- 评分算法与时间衰退机制
- CLI使用示例与集成方式
- 内部参数常量说明"
# 单行简短提交
git commit -m "chore(gitignore): 增强隐私文件覆盖范围"
Commit前最终检查：
pytest -q 确保测试全部通过git status 确认暂存内容正确（无敏感文件）# 1. 验证gitignore
cat .gitignore | grep -E "(__pycache__|\.venv|data/|\.last_config_path)"
# 2. 查看改动摘要
git diff --cached --stat
# 3. 编辑CHANGELOG.md（若需版本发布）
# （手动编辑或使用工具）
# 4. 执行commit（示例）
git commit -m "feat(memory): 实现记忆质量评估与智能遗忘
[详细描述...]"
# 5. 验证commit已正确提交
git log --oneline -1
.gitignore 未包含隐私文件或运行时缓存。pytest -q 返回非0）。