wanggang316

FDD 主流程 step 1（规划与拆解）。覆盖两段——plan（与用户弄清需求、经 investigator 调查代码库、定出 milestone、写出 plan.md 并呈现）与 features（把 milestone 拆成 features.json 并过 coverage 闸）。中间的 contract 段交给 harness-stack:fdd-validation-contract。由 harness-stack:fdd 调用。

构建新特性的主流程编排器。契约优先的多 agent 架构——捕获一个 plan，定义可测试的断言，拆解为多个 feature，再用全新上下文的 implementer/reviewer/validator subagent 驱动一个里程碑设闸的执行循环。当一处改动触及多个文件、有多条验收标准、或跨越多个 feature 时使用。主流程分三步，分发给 fdd-planning（含 fdd-validation-contract）/ fdd-execution / fdd-validate。

为一个 plan 撰写 validation contract——把 definition of done 落成一组可测试、用户可观测的 assertion（VAL-<AREA>-NNN），带 persona 与声明的 Evidence。它是 fdd step 1（规划）里的 contract 阶段。契约通过逐 area 的 investigation subagent 与若干轮 adversarial review 构建，而非一人独写。产出 .harness-runtime/plans/<slug>/validation-contract.md，并经由 fdd init-state 播种 validation-state.json。在项目内首次使用时，还会 bootstrap 项目级约定文档 docs/user-test-patterns.md。

规范 git 工作流实践。任何代码改动都适用。在提交、开分支、解决冲突，或需要把多条并行工作线组织起来时使用。

harness-stack 框架的引导纲要（bootstrap doctrine）。在会话开始时自动加载，用以介绍 lifecycle map、golden rules，以及如何挑选正确的 harness-stack:* skill。在一次会话中首次调用任何 harness-stack:* skill 之前，先读它。

复盘一次 harness-stack 使用，把值得上报的摩擦、缺陷或建议提成 GitHub Issue 反馈给上游。在完成一项任务、用完某个 skill 后有意见或改进想法，或想为框架本身留下改进线索时使用。

FDD 主流程 step 2——执行循环。串行驱动 feature 构建：next-feature → 派 implementer → handoff 决策树 → complete。每个 feature 由交接决策树把关（核验 implementer 自验留下的证据）。静态验证 → 代码审查 → user-test 这条验证流水线在里程碑收口（fdd-validate scope=milestone）与循环跑空（scope=final）批量跑。由 harness-stack:fdd 在 features.json 通过 coverage 后调用。

FDD 的验证流水线——里程碑 / 最终批量闸。一条线性、成本递增的三级 gate：静态验证（scrutiny-validator 硬门禁 test/lint/type-check + 逐 feature scrutiny）→ 代码审查（code-reviewer，逐 feature）→ user-test（运行时断言探测）。由 harness-stack:fdd-execution 在里程碑收口（scope=milestone：加条件 security-auditor + 治理反馈 + seal）与循环跑空（scope=final：加 coverage gate + fdd gate）时调用。

Triage and resolve a codans crash reported to Sentry. Pull the symbolicated stack from the Sentry API, map the in-app frame to source, fix the root cause, and drive the issue's status (resolve / resolve-in-next-release / archive) with an audit trail. Use when the user references a Sentry crash, a SIGABRT / EXC_BAD_ACCESS / SIGSEGV / NSException report, a dashboard issue id like APPLE-MACOS-4, release health, or asks to triage / fix / resolve crashes.

每晚审阅当天提交的代码 diff，检测 docs/ 知识库的漂移（liveness 漂移、过程词、与代码矛盾），低风险事实更新直接落盘到分支、其余实质漂移产出报告并开 PR 交人审。仅当用户要求运行 doc-sync 或配置每日文档同步时触发，不要在常规对话中自动调用。

Drive the codans Mac app from a terminal with the `codans` CLI — inspect the Project / Worktree / Tab / Pane hierarchy, create and switch worktrees, spawn tabs and panes, send keystrokes or text to a pane, read back its rendered output, broadcast input across panes, and check app health. Use this skill whenever the user is operating inside a codans Pane, references the `codans` command, asks how to script codans, or wants to coordinate panes / worktrees / agents from the shell. Prefer `codans tree` to discover state before issuing any other command.

Cut a codans stable release. Bump MARKETING_VERSION in Project.xcconfig, promote CHANGELOG [Unreleased] to a dated version section, commit, tag vX.Y.Z, and push to trigger the GitHub Actions Developer-ID release pipeline. Use when shipping a new stable build.

Make code modifications in a GitHub repository using the gh CLI.

Answer questions from GitHub issue or PR comments using the gh CLI.

Perform code review on a GitHub pull request using the gh CLI.

Guide for authoring and implementing ExecPlans — self-contained execution plans that enable any agent or novice to deliver a working feature. Use when planning complex work, writing design docs, or creating step-by-step implementation guides.

Cut a HandBox release. Bump the version in package.json + src-tauri/tauri.conf.json + src-tauri/Cargo.toml (and regenerate Cargo.lock), promote CHANGELOG [Unreleased] to a dated version section, commit, tag vX.Y.Z (annotated, --cleanup=verbatim), and push to trigger the GitHub Actions Tauri release pipeline (signed + notarized macOS builds + updater latest.json). Use when shipping a new build.

Query HandBox SQLite database located in Tauri sandbox. Use when user asks to check database contents, query chats, messages, models, providers, or any database-related information. Requires sqlite3 command-line tool.

把当前会话中的主题/资料生成为一个独立可浏览的 HTML 页面（结构清晰、化繁为简、由浅入深，强调图形/表格/动效与精致的 UI/UE），落地到你的画廊仓库并自动 commit + push + 在浏览器中打开。常规入口是 `/agent-pages <主题或说明>`。

agent-pages 的引导纲要（bootstrap doctrine）。会话开始时自动注入，用以说明 /agent-pages 的入口、何时建议它、以及生成页面时的硬约束。在真正开始写页面 / 发布之前，先按本文挑入口；完整工作流见 agent-pages:agent-pages skill。

Translate web articles, blog posts, essays, and technical posts from a URL into Chinese Markdown files. Use this skill only when the user explicitly asks to translate, with requests like '翻译这篇文章', '翻译一下这个链接', '把这个网页翻成中文', 'translate this post', or asks to continue translating an existing article directory. Do not trigger this skill for a bare URL alone without translation intent.

Tauri v2 + Svelte 5 project toolkit. Bootstraps new projects and provides capabilities for icon replacement, system tray configuration, auto-updater setup, and Markdown rendering.

Use when driving the Nutcrack service from the terminal with the `nutcrack` CLI — configuring the base URL / API token, verifying a token, and adding / batch-adding / getting / listing links. Covers local config storage, authentication, every command and flag, batch-file formats, text vs JSON output, and exit codes. Source of truth is `cli/src/`, not `cli/README.md` (that README is stale — it predates the rename and lists commands the CLI does not implement).

Cut a Linko release. Bump the shared version in project.yml, promote CHANGELOG [Unreleased] to a dated section, commit atomically, build+sign+notarize+package locally via `make release`, tag vX.Y.Z, and publish the signed DMG + appcast.xml to GitHub Releases. Use when shipping a new build to Sparkle clients.