القائمة
StoryMoss 文档维护规范、docs of record 清单、版本号同步、提交信息与 house style。何时加载：要发布或推送、要写/更新文档、要 bump 版本、要写 commit message、或被问“文档怎么写/要更新哪些/版本号在哪”时。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
运行/部署 StoryMoss 的命令解剖、运行时数据与产物落点。何时加载：要启动应用、要找日志、要找数据库/配置文件、要发布 tag、要看生成链路日志、或被问“日志在哪/数据在哪/怎么发布”时。
Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.
StoryMoss 承重设计决策与 WHY、必须成立的不变量、已知弱点。何时加载：要改架构、要动数据真相源、要改生成链路、要改 IPC/SyncEvent、要动数据库层、要评估“能不能这样改”、或被问“为什么这样设计/哪些不能动”时。改任何符号前先用 gitnexus impact。
从零重建 StoryMoss 开发与构建环境，含已知陷阱。何时加载：首次 clone 后要跑起来、换机器、CI 本地复现、`cargo tauri dev/build` 报环境错、前端起不来、跨平台构建失败、或被问“怎么构建/怎么跑”时。
StoryMoss 变更门禁与不可破坏项。何时加载：要提交/推送代码、要 bump 版本、要改架构边界、要动数据库迁移、要改 CI、要发布 tag、要合并 feature 分支、或被问“能不能直接改/直接推”时。也用于判断一个改动是否需要用户授权（R10）。
StoryMoss 全部配置轴：选项、默认值、生产 vs 实验、守卫、如何新增。何时加载：要改生成模式、要改并发/超时、要加 PromptRegistry 覆盖、要调体裁模板、要改 silent_background 白名单、要动 rustfmt、或被问“在哪配/默认是什么/这个开关干啥”时。
| name | sf-docs-and-writing |
| description | StoryMoss 文档维护规范、docs of record 清单、版本号同步、提交信息与 house style。何时加载：要发布或推送、要写/更新文档、要 bump 版本、要写 commit message、或被问“文档怎么写/要更新哪些/版本号在哪”时。 |
| 文档 | 用途 | 更新时机 |
|---|---|---|
README.md | 面向用户的总览 + 安装 + 截图 | 用户可见行为变化、新功能、新版本动态 |
CHANGELOG.md | 版本变更日志 | 每次版本 bump |
AGENTS.md | AI 助手项目指南（背景/编码风格/命令/强制规则/最近完成） | 每次推送（最近完成功能段） |
PROJECT_STATUS.md | 项目状态 | 每次推送 |
ROADMAP.md | 路线图 + 已知债务 | 每次推送；新增债务/暂缓决策必须登记 |
ARCHITECTURE.md | 系统架构（含分时介入、合同驱动、记忆系统等） | 架构变化 |
TESTING.md | 测试环境与统计 | 测试数量/分布变化 |
docs/USER_GUIDE.md | 完整用户指南 | 用户操作路径变化（如 auto-accept 真实路径） |
规则的家在
sf-change-control（含违反代价与历史事故）。本技能只记 docs 视角：写文档时引用的版本号必须与四源一致——src-tauri/Cargo.toml的version、src-tauri/tauri.conf.json的"version"、src-frontend/package.json的"version"、git tag vX.Y.Z。Cargo.lock也需同步（曾出现需chore: sync Cargo.lock）。
<type>: <subject>
type: feat / fix / docs / style / refactor / test / chore
历史风格（git log --oneline -30）：
fix: v0.26.23 修复 v0.26.22 CI prettier 格式检查失败feat: v0.26.19 Genesis 创世流程全面审计与测试加固style: v0.26.20 修复 v0.26.19 CI cargo +nightly fmt -- --check 失败chore: sync Cargo.lock version to v0.26.17约定：subject 常带版本号；多版本连发修 CI 格式时用 style:/fix:。
snake_case，Result<T,E>，async/await，rusqlite+r2d2。camelCase，函数组件 + Hooks，Zustand，TanStack Query。cargo test --lib 655 passed (+10)）。ROADMAP.md 的「已知债务」段登记，含暂缓原因 + 重评估条件（参考「策略选择移入 quick_phase」条目）。sf-run-and-operate。sf-change-control。sf-architecture-contract。grep -rE '^version' src-tauri/Cargo.toml src-frontend/package.json + grep '"version"' src-tauri/tauri.conf.json + git tag --sort=-creatordate | head -3git log --oneline -10（提交风格）ls docs/ docs/archive/（文档清单）