qiao-925
@qiao-925
Public Skills
w01-requirement-discovery
by qiao-925
需求发现规范，适用于探索性场景，通过角色扮演帮助用户在迷茫中发现高ROI功能方向。自动触发，纯对话式启发。
architecture-governance
by qiao-925
通用架构治理规范，提供分层约束、影响面分析、接口契约与依赖注入基线。适用于任何多层系统的架构评审、重构与新模块设计。
whetstone
by qiao-925
把「原文 + 读者批注」整理成「编号批注 + 对应原文」的结构化笔记，并产出 AI 总结。人写批注，技能负责编号、对应、格式与总结。触发：批注式整理 / 磨刀石模式 / 二创式整理 / 批注式阅读与整理，或 /whetstone。
agent-skill-rules
by qiao-925
Agent Skills 开放标准与治理规则。用于 skill 的创建、修改、重构、迁移、审计与维护，提供平台无关的结构标准、frontmatter 规范、渐进式披露与质量门禁。
w04-review-gate
by qiao-925
任务执行完成后，提示用户新开 Agent 审查 git 未提交代码。运动员不当裁判，审查通过后再收尾。
file-header-comments
by qiao-925
代码文件顶部注释规范，适用于所有代码文件（.sh, .js, .ts, .py, .java, .go 等）。要求所有代码文件在顶部包含功能描述注释。
critical-thinking-guidance
by qiao-925
思考引导机制，要求 Agent 在给出答案前先提出引导性问题，帮助用户主动思考，避免认知能力退化。适用于用户提问、方案咨询、学习交流等交互场景。
python-coding-standards
by qiao-925
Python 编码规范，包括类型提示、日志规范、命名约定、代码结构等。适用于所有 Python 代码文件。
w02-task-planning
by qiao-925
任务规划规范，适用于复杂任务（≥3步），包含需求决策和计划书创建。包含规划规范、需求决策流程和计划书生成工具。
w05-task-closure
by qiao-925
任务收尾规范，包含日志生成和优化分析。适用于主要交付完成后的收尾阶段。
cs-rag-architecture-guideline
by qiao-925
CS-RAG 项目专用架构总规范，统一全局架构认知与架构设计约束，提供分层检查、影响面分析、接口契约、依赖注入与可插拔治理入口。
python-uv-acceleration
by qiao-925
在 Python 项目中默认使用 uv 替代 pip 进行依赖管理和虚拟环境创建，提升 10-100x 安装速度。当处理 Python 项目、创建虚拟环境、安装依赖、或用户提到 pip/venv/virtualenv 时使用。
file-size-limit
by qiao-925
文件行数限制规范，单个代码文件必须≤300行。这是硬性限制，不允许例外。
single-responsibility
by qiao-925
单一职责原则，确保代码文件、函数、模块职责清晰单一。适用于所有代码文件。
doc-driven-development
by qiao-925
文档驱动开发规范，要求 Agent 在生成代码或修复 bug 前先查阅官方文档与示例，包含 API 验证流程、搜索策略与 MCP 调用规则。适用于接入第三方库、排查 API 报错、版本变更等场景。
core-first-simplicity
by qiao-925
基于 KISS（Keep It Simple, Stupid）与“最小光辉点”的复杂度控制原则。用于项目、系统、模块、代码、函数各层级的设计与实现决策，帮助优先核心价值、减少非必要复杂度、避免过度设计。关键词：KISS、简化、聚焦、复杂度控制、最小光辉点。
w03-testing-and-diagnostics
by qiao-925
测试与诊断工作流，包含单元测试和浏览器测试，测试失败时自动诊断。适用于代码变更后的测试执行与排障。
project-principles
by qiao-925
（兼容入口）项目聚焦原则已并入 core-first-simplicity 的 project-level。用于兼容旧触发词并将请求路由到统一复杂度控制规则。
ai-collaboration-principles
by qiao-925
AI协作总原则，规范 Agent 的协作行为与方法论：角色定位、系统性分析、风险评估、授人以渔、方案对比、质量优先。适用于所有 AI Agent 交互场景。
w00-workflow-checkpoint
by qiao-925
Workflow Checkpoint 基础能力（聚焦存档与读档）：在 GitHub Issues 中记录 checkpoint 进展并读档上下文。适用于任意 workflow 阶段，支持自动触发与手动高频调用。关键词：存档、读档、checkpoint、issue。
prompt-recommendation
by qiao-925
Prompt 智能推荐与快速决策规则，包含任务类型分析、Prompt 选择与引用流程。用于需要从 prompt-toolkit 中选择/推荐 Prompt、或用户要求写作/优化/总结等内容时。