Imported from tense-i/tslink (
sdk/tslink-rsdk/AGENTS.md). Install upstream withnpx skills add tense-i/tslink --skill tslink-rsdk. Copyright stays with the author.
AGENTS.md
开发流程规范(强制)
Spec-Driven Development (SDD) + Plane 闭环
本项目采用 Speckit SDD 开发方式,所有功能开发必须遵循以下流程:
1. /speckit.specify → 输出 spec.md(需求/范围/验收标准)
2. /speckit.plan → 输出 plan.md(架构/数据模型/API/测试策略)
3. /speckit.tasks → 输出 tasks.md(细粒度、可测试、依赖明确的任务)
4. Tasks → Plane → 将 tasks.md 中的任务项同步到 Plane work items
5. /speckit.implement → 按 tasks.md 逐条执行,状态回写 Plane
关键规则
- 禁止跳过 SDD 流程直接编码。任何新功能/模块必须先经过 specify → plan → tasks 三阶段。
- tasks.md 生成后必须同步到 Plane。使用
sdd-plane-bridgeskill 或手动调用 Plane MCP 创建 work items。 - Plane 是任务状态的 single source of truth。开发进度通过 Plane work item 状态流转跟踪:
Backlog → Todo → In Progress → In Review → Done - 证据回填:完成任务后,在 Plane work item 的 comment 中添加实现证据(测试结果、PR 链接等)。
- Spec 是需求的 single source of truth。实现过程中发现需求偏差,先更新 spec.md 再调整代码。
SDD 产物存放路径
/specs/<SPEC_ID>/spec.md — 需求规格
/specs/<SPEC_ID>/plan.md — 技术方案
/specs/<SPEC_ID>/tasks.md — 任务清单
Plane 工单命名规范
- Plane提工单属性必须要填写完整,比如时间、优先级、属于的cycels、modlues等。
- 功能任务:
[SPEC-ID][Txx] <短动词>:<对象> - Bug:
[BUG] <问题描述> - 技术债务:
[TECH-DEBT] <描述> - 紧急修复:
[HOTFIX] <描述>
详细流程参见 skills/sdd-plane-bridge/SKILL.md。
存在的skills
Auto-generated from
./skills/**/SKILL.mdfrontmatter (name/description).
| 名称 | 路径 | 功能简述 |
|---|---|---|
attack-tree-construction |
skills/attack-tree-construction/SKILL.md |
Build comprehensive attack trees to visualize threat paths. Use when mapping attack scenarios, identifying defense gaps, or communicating security risks to stakeholders. |
auth-implementation-patterns |
skills/auth-implementation-patterns/SKILL.md |
Master authentication and authorization patterns including JWT, OAuth2, session management, and RBAC to build secure, scalable access control systems. Use when implementing auth systems, securing APIs, or debugging security issues. |
cqrs-implementation |
skills/cqrs-implementation/SKILL.md |
Implement Command Query Responsibility Segregation for scalable architectures. Use when separating read and write models, optimizing query performance, or building event-sourced systems. |
debugging-strategies |
skills/debugging-strategies/SKILL.md |
Master systematic debugging techniques, profiling tools, and root cause analysis to efficiently track down bugs across any codebase or technology stack. Use when investigating bugs, performance issues, or unexpected behavior. |
discover-protocols |
skills/discover-protocols/SKILL.md |
Automatically discover protocol skills when working with HTTP, TCP, UDP, QUIC, and network protocols |
distributed-tracing |
skills/distributed-tracing/SKILL.md |
Implement distributed tracing with Jaeger and Tempo to track requests across microservices and identify performance bottlenecks. Use when debugging microservices, analyzing request flows, or implementing observability for distributed systems. |
embedded-systems |
skills/embedded-systems/SKILL.md |
Expert embedded systems engineer specializing in microcontroller programming, RTOS development, and hardware optimization. Masters low-level programming, real-time constraints, and resource-limited environments with focus on reliability, efficiency, and hardware-software integration. |
error-handling-patterns |
skills/error-handling-patterns/SKILL.md |
Master error handling patterns across languages including exceptions, Result types, error propagation, and graceful degradation to build resilient applications. Use when implementing error handling, designing APIs, or improving application reliability. |
github-actions-templates |
skills/github-actions-templates/SKILL.md |
Create production-ready GitHub Actions workflows for automated testing, building, and deploying applications. Use when setting up CI/CD with GitHub Actions, automating development workflows, or creating reusable workflow templates. |
grafana-dashboards |
skills/grafana-dashboards/SKILL.md |
Create and manage production Grafana dashboards for real-time visualization of system and application metrics. Use when building monitoring dashboards, visualizing metrics, or creating operational observability interfaces. |
helm-chart-scaffolding |
skills/helm-chart-scaffolding/SKILL.md |
Design, organize, and manage Helm charts for templating and packaging Kubernetes applications with reusable configurations. Use when creating Helm charts, packaging Kubernetes applications, or implementing templated deployments. |
iot-developer |
skills/iot-developer/SKILL.md |
Expert in IoT development, microcontrollers, sensors, and MQTT protocols |
kubernetes-deployment |
skills/kubernetes-deployment/SKILL.md |
Deploy, manage, and scale containerized applications on Kubernetes clusters with best practices for production workloads, resource management, and rolling updates. |
log-analysis |
skills/log-analysis/SKILL.md |
Analyze application and system logs to identify errors, patterns, and root causes. Use log aggregation tools and structured logging for effective debugging. |
logging-best-practices |
skills/logging-best-practices/SKILL.md |
Implement structured logging with JSON formats, log levels (DEBUG, INFO, WARN, ERROR), contextual logging, PII handling, and centralized logging. Use for logging, observability, log levels, structured logs, or debugging. |
mtls-configuration |
skills/mtls-configuration/SKILL.md |
Configure mutual TLS (mTLS) for zero-trust service-to-service communication. Use when implementing zero-trust networking, certificate management, or securing internal service communication. |
openapi-spec-generation |
skills/openapi-spec-generation/SKILL.md |
Generate and maintain OpenAPI 3.1 specifications from code, design-first specs, and validation patterns. Use when creating API documentation, generating SDKs, or ensuring API contract compliance. |
opentelemetry |
skills/opentelemetry/SKILL.md |
Implement OpenTelemetry (OTEL) observability - Collector configuration, Kubernetes deployment, traces/metrics/logs pipelines, instrumentation, and troubleshooting. Use when working with OTEL Collector, telemetry pipelines, observability infrastructure, or Kubernetes monitoring. |
owasp-security |
skills/owasp-security/SKILL.md |
Implement secure coding practices following OWASP Top 10. Use when preventing security vulnerabilities, implementing authentication, securing APIs, or conducting security reviews. Triggers on OWASP, security, XSS, SQL injection, CSRF, authentication security, secure coding, vulnerability. |
prometheus-configuration |
skills/prometheus-configuration/SKILL.md |
Set up Prometheus for comprehensive metric collection, storage, and monitoring of infrastructure and applications. Use when implementing metrics collection, setting up monitoring infrastructure, or configuring alerting systems. |
property-based-testing |
skills/property-based-testing/SKILL.md |
Design property-based tests that verify code properties hold for all inputs using automatic test case generation. Use for property-based, QuickCheck, hypothesis testing, generative testing, and invariant verification. |
running-load-tests |
skills/running-load-tests/SKILL.md |
Create and execute load tests for performance validation using k6, JMeter, and Artillery. Use when validating application performance under load conditions or identifying bottlenecks. Trigger with phrases like "run load test", "create stress test", or "validate performance under load". |
rust-engineer |
skills/rust-engineer/SKILL.md |
Use when building Rust applications requiring memory safety, systems programming, or zero-cost abstractions. Invoke for ownership patterns, lifetimes, traits, async/await with tokio. |
rust-router |
skills/rust-router/SKILL.md |
"CRITICAL: Use for ALL Rust questions including errors, design, and coding. |
rust-testing-verification |
skills/rust-testing-verification/SKILL.md |
Comprehensive testing strategies for Rust including property-based testing with proptest, fuzz testing with cargo-fuzz, benchmark testing with Criterion, contract testing for traits, and Miri for undefined behavior detection. Use when writing tests, ensuring code correctness, detecting edge cases, or measuring performance. |
sdd-plane-bridge |
skills/sdd-plane-bridge/SKILL.md |
将 Spec-Driven Development(Spec Kit / SDD)+ Vibe Coding 的 spec/plan/tasks 产物自动落到 Plane,并通过状态回写形成端到端闭环:PRD -> Spec -> Plane Work Items -> Implement -> Verify -> Close。支持项目全生命周期:初始化、新需求、缺陷修复、技术债务、紧急修复等场景。 |
security-requirement-extraction |
skills/security-requirement-extraction/SKILL.md |
Derive security requirements from threat models and business context. Use when translating threats into actionable requirements, creating security user stories, or building security test cases. |
stride-analysis-patterns |
skills/stride-analysis-patterns/SKILL.md |
Apply STRIDE methodology to systematically identify threats. Use when analyzing system security, conducting threat modeling sessions, or creating security documentation. |
threat-mitigation-mapping |
skills/threat-mitigation-mapping/SKILL.md |
Map identified threats to appropriate security controls and mitigations. Use when prioritizing security investments, creating remediation plans, or validating control effectiveness. |